From 04a1e3ce77ae395a5ad1cd8bcd7ae318088c0715 Mon Sep 17 00:00:00 2001 From: Automated Date: Wed, 12 Jun 2024 09:25:04 +0000 Subject: [PATCH] gcloud: Wed Jun 12 09:25:04 UTC 2024 --- gcloud/_version | 8 +- gcloud/alpha/audit-manager/enrollments/add | 12 +- .../blockchain-validator-configs/create | 290 ++++++++++++++++++ .../blockchain-validator-configs/delete | 91 ++++++ .../blockchain-validator-configs/describe | 74 +++++ .../blockchain-validator-configs/help | 40 +++ .../blockchain-validator-configs/list | 90 ++++++ .../blockchain-validator-configs/update | 195 ++++++++++++ gcloud/alpha/blockchain-validator/help | 31 ++ .../blockchain-validator/operations/cancel | 65 ++++ .../blockchain-validator/operations/delete | 65 ++++ .../blockchain-validator/operations/describe | 65 ++++ .../blockchain-validator/operations/help | 38 +++ .../blockchain-validator/operations/list | 86 ++++++ .../blockchain-validator/operations/wait | 65 ++++ gcloud/alpha/compute/backend-services/create | 19 +- gcloud/alpha/compute/backend-services/update | 19 +- gcloud/alpha/compute/commitments/create | 9 +- .../compute/commitments/update-reservations | 14 +- gcloud/alpha/compute/disks/create | 8 +- gcloud/alpha/compute/disks/update | 8 +- gcloud/alpha/compute/images/import | 12 + .../instances/ops-agents/policies/create | 1 + .../instances/ops-agents/policies/update | 1 + .../compute/network-endpoint-groups/create | 20 +- .../compute/network-endpoint-groups/update | 6 +- gcloud/alpha/compute/reservations/update | 5 +- gcloud/alpha/container/fleet/help | 3 + .../fleet/memberships/get-credentials | 2 +- gcloud/alpha/container/fleet/packages/create | 42 +++ gcloud/alpha/container/fleet/packages/delete | 68 ++++ .../alpha/container/fleet/packages/describe | 68 ++++ gcloud/alpha/container/fleet/packages/help | 48 +++ gcloud/alpha/container/fleet/packages/list | 67 ++++ .../fleet/packages/resource-bundles/create | 43 +++ .../fleet/packages/resource-bundles/delete | 44 +++ .../fleet/packages/resource-bundles/describe | 39 +++ .../fleet/packages/resource-bundles/help | 47 +++ .../fleet/packages/resource-bundles/list | 69 +++++ .../packages/resource-bundles/releases/create | 72 +++++ .../packages/resource-bundles/releases/delete | 45 +++ .../resource-bundles/releases/describe | 45 +++ .../packages/resource-bundles/releases/help | 41 +++ .../packages/resource-bundles/releases/list | 73 +++++ .../packages/resource-bundles/releases/update | 76 +++++ .../fleet/packages/resource-bundles/update | 43 +++ .../container/fleet/packages/rollouts/abort | 74 +++++ .../fleet/packages/rollouts/describe | 47 +++ .../container/fleet/packages/rollouts/help | 40 +++ .../container/fleet/packages/rollouts/list | 77 +++++ .../container/fleet/packages/rollouts/resume | 74 +++++ .../container/fleet/packages/rollouts/suspend | 74 +++++ gcloud/alpha/container/fleet/packages/update | 68 ++++ gcloud/alpha/container/hub/help | 3 + .../container/hub/memberships/get-credentials | 2 +- gcloud/alpha/container/hub/packages/create | 42 +++ gcloud/alpha/container/hub/packages/delete | 68 ++++ gcloud/alpha/container/hub/packages/describe | 68 ++++ gcloud/alpha/container/hub/packages/help | 47 +++ gcloud/alpha/container/hub/packages/list | 67 ++++ .../hub/packages/resource-bundles/create | 43 +++ .../hub/packages/resource-bundles/delete | 44 +++ .../hub/packages/resource-bundles/describe | 39 +++ .../hub/packages/resource-bundles/help | 47 +++ .../hub/packages/resource-bundles/list | 69 +++++ .../packages/resource-bundles/releases/create | 72 +++++ .../packages/resource-bundles/releases/delete | 45 +++ .../resource-bundles/releases/describe | 45 +++ .../packages/resource-bundles/releases/help | 41 +++ .../packages/resource-bundles/releases/list | 73 +++++ .../packages/resource-bundles/releases/update | 76 +++++ .../hub/packages/resource-bundles/update | 43 +++ .../container/hub/packages/rollouts/abort | 73 +++++ .../container/hub/packages/rollouts/describe | 47 +++ .../container/hub/packages/rollouts/help | 39 +++ .../container/hub/packages/rollouts/list | 77 +++++ .../container/hub/packages/rollouts/resume | 74 +++++ .../container/hub/packages/rollouts/suspend | 74 +++++ gcloud/alpha/container/hub/packages/update | 68 ++++ gcloud/alpha/dataplex/entries/help | 3 + gcloud/alpha/dataplex/entries/search | 63 ++++ gcloud/alpha/domains/registrations/help | 6 + .../registrations/initiate-push-transfer | 78 +++++ gcloud/alpha/domains/registrations/register | 7 +- .../alpha/domains/registrations/renew-domain | 83 +++++ gcloud/alpha/functions/deploy | 6 +- gcloud/alpha/healthcare/fhir-stores/create | 14 +- gcloud/alpha/healthcare/fhir-stores/update | 13 +- gcloud/alpha/network-services/help | 18 ++ .../multicast-consumer-associations/create | 99 ++++++ .../multicast-consumer-associations/delete | 70 +++++ .../multicast-consumer-associations/describe | 71 +++++ .../multicast-consumer-associations/help | 37 +++ .../multicast-consumer-associations/list | 89 ++++++ .../multicast-domain-activations/create | 95 ++++++ .../multicast-domain-activations/delete | 70 +++++ .../multicast-domain-activations/describe | 71 +++++ .../multicast-domain-activations/help | 37 +++ .../multicast-domain-activations/list | 90 ++++++ .../create | 100 ++++++ .../delete | 72 +++++ .../describe | 72 +++++ .../multicast-group-consumer-activations/help | 37 +++ .../multicast-group-consumer-activations/list | 90 ++++++ .../multicast-group-definitions/create | 100 ++++++ .../multicast-group-definitions/delete | 70 +++++ .../multicast-group-definitions/describe | 70 +++++ .../multicast-group-definitions/help | 37 +++ .../multicast-group-definitions/list | 89 ++++++ .../network-services/multicast-groups/create | 98 ++++++ .../network-services/multicast-groups/delete | 68 ++++ .../multicast-groups/describe | 69 +++++ .../network-services/multicast-groups/help | 37 +++ .../network-services/multicast-groups/list | 86 ++++++ .../network-services/route-views/describe | 100 ++++++ .../alpha/network-services/route-views/help | 30 ++ .../alpha/network-services/route-views/list | 119 +++++++ gcloud/alpha/pubsub/subscriptions/create | 15 +- gcloud/alpha/pubsub/subscriptions/update | 15 +- gcloud/alpha/spanner/databases/change-quorum | 107 +++++++ gcloud/alpha/spanner/databases/create | 7 +- gcloud/alpha/spanner/databases/ddl/describe | 11 +- gcloud/alpha/spanner/databases/ddl/update | 9 +- gcloud/alpha/spanner/databases/help | 3 + gcloud/alpha/spanner/operations/cancel | 3 +- gcloud/alpha/spanner/operations/describe | 4 +- gcloud/alpha/spanner/operations/help | 6 +- gcloud/alpha/spanner/operations/list | 3 +- gcloud/alpha/workstations/configs/create | 52 +++- gcloud/alpha/workstations/configs/update | 52 +++- gcloud/artifacts/files/delete | 84 +++++ gcloud/artifacts/files/help | 3 + gcloud/beta/compute/backend-services/create | 19 +- gcloud/beta/compute/backend-services/update | 19 +- gcloud/beta/compute/commitments/create | 9 +- .../compute/commitments/update-reservations | 14 +- gcloud/beta/compute/disks/create | 14 +- gcloud/beta/compute/disks/update | 10 +- gcloud/beta/compute/images/import | 12 + .../instances/ops-agents/policies/create | 1 + .../instances/ops-agents/policies/update | 1 + .../compute/network-endpoint-groups/create | 16 +- .../compute/network-endpoint-groups/update | 16 +- gcloud/beta/compute/reservations/create | 7 +- gcloud/beta/compute/reservations/update | 5 +- .../fleet/memberships/get-credentials | 2 +- .../container/hub/memberships/get-credentials | 2 +- .../datastream/connection-profiles/create | 42 ++- .../datastream/connection-profiles/discover | 8 +- .../datastream/connection-profiles/update | 30 +- gcloud/beta/datastream/streams/create | 61 +++- gcloud/beta/datastream/streams/update | 61 +++- gcloud/beta/domains/registrations/help | 6 + .../registrations/initiate-push-transfer | 76 +++++ gcloud/beta/domains/registrations/register | 7 +- .../beta/domains/registrations/renew-domain | 81 +++++ gcloud/beta/functions/deploy | 6 +- gcloud/beta/healthcare/fhir-stores/create | 14 +- gcloud/beta/healthcare/fhir-stores/update | 13 +- gcloud/beta/pubsub/subscriptions/create | 15 +- gcloud/beta/pubsub/subscriptions/update | 15 +- gcloud/beta/spanner/databases/change-quorum | 105 +++++++ gcloud/beta/spanner/databases/create | 7 +- gcloud/beta/spanner/databases/ddl/describe | 10 +- gcloud/beta/spanner/databases/ddl/update | 9 +- gcloud/beta/spanner/databases/help | 3 + gcloud/beta/spanner/operations/cancel | 6 + gcloud/beta/spanner/operations/describe | 5 + gcloud/beta/spanner/operations/list | 17 + gcloud/beta/workstations/configs/create | 52 +++- gcloud/beta/workstations/configs/update | 52 +++- gcloud/compute/backend-services/create | 19 +- gcloud/compute/backend-services/update | 19 +- gcloud/compute/commitments/create | 9 +- gcloud/compute/disks/create | 13 +- gcloud/compute/disks/update | 11 +- gcloud/compute/images/import | 12 + gcloud/compute/reservations/create | 7 +- gcloud/compute/target-https-proxies/create | 25 +- gcloud/compute/target-https-proxies/update | 26 +- .../fleet/memberships/get-credentials | 2 +- .../container/hub/memberships/get-credentials | 2 +- gcloud/dataplex/entries/help | 3 + gcloud/dataplex/entries/search | 60 ++++ gcloud/datastream/connection-profiles/create | 42 ++- .../datastream/connection-profiles/discover | 8 +- gcloud/datastream/connection-profiles/update | 30 +- gcloud/datastream/objects/lookup | 16 +- gcloud/datastream/streams/create | 61 +++- gcloud/datastream/streams/update | 61 +++- gcloud/domains/registrations/help | 6 + .../registrations/initiate-push-transfer | 75 +++++ gcloud/domains/registrations/register | 7 +- gcloud/domains/registrations/renew-domain | 79 +++++ gcloud/functions/deploy | 6 +- gcloud/pubsub/subscriptions/create | 15 +- gcloud/pubsub/subscriptions/update | 15 +- gcloud/redis/clusters/create | 17 +- gcloud/secrets/create | 12 + gcloud/secrets/update | 25 +- gcloud/spanner/databases/change-quorum | 103 +++++++ gcloud/spanner/databases/create | 6 + gcloud/spanner/databases/ddl/describe | 10 +- gcloud/spanner/databases/ddl/update | 9 +- gcloud/spanner/databases/help | 3 + 205 files changed, 8281 insertions(+), 231 deletions(-) create mode 100644 gcloud/alpha/blockchain-validator/blockchain-validator-configs/create create mode 100644 gcloud/alpha/blockchain-validator/blockchain-validator-configs/delete create mode 100644 gcloud/alpha/blockchain-validator/blockchain-validator-configs/describe create mode 100644 gcloud/alpha/blockchain-validator/blockchain-validator-configs/help create mode 100644 gcloud/alpha/blockchain-validator/blockchain-validator-configs/list create mode 100644 gcloud/alpha/blockchain-validator/blockchain-validator-configs/update create mode 100644 gcloud/alpha/blockchain-validator/help create mode 100644 gcloud/alpha/blockchain-validator/operations/cancel create mode 100644 gcloud/alpha/blockchain-validator/operations/delete create mode 100644 gcloud/alpha/blockchain-validator/operations/describe create mode 100644 gcloud/alpha/blockchain-validator/operations/help create mode 100644 gcloud/alpha/blockchain-validator/operations/list create mode 100644 gcloud/alpha/blockchain-validator/operations/wait create mode 100644 gcloud/alpha/container/fleet/packages/create create mode 100644 gcloud/alpha/container/fleet/packages/delete create mode 100644 gcloud/alpha/container/fleet/packages/describe create mode 100644 gcloud/alpha/container/fleet/packages/help create mode 100644 gcloud/alpha/container/fleet/packages/list create mode 100644 gcloud/alpha/container/fleet/packages/resource-bundles/create create mode 100644 gcloud/alpha/container/fleet/packages/resource-bundles/delete create mode 100644 gcloud/alpha/container/fleet/packages/resource-bundles/describe create mode 100644 gcloud/alpha/container/fleet/packages/resource-bundles/help create mode 100644 gcloud/alpha/container/fleet/packages/resource-bundles/list create mode 100644 gcloud/alpha/container/fleet/packages/resource-bundles/releases/create create mode 100644 gcloud/alpha/container/fleet/packages/resource-bundles/releases/delete create mode 100644 gcloud/alpha/container/fleet/packages/resource-bundles/releases/describe create mode 100644 gcloud/alpha/container/fleet/packages/resource-bundles/releases/help create mode 100644 gcloud/alpha/container/fleet/packages/resource-bundles/releases/list create mode 100644 gcloud/alpha/container/fleet/packages/resource-bundles/releases/update create mode 100644 gcloud/alpha/container/fleet/packages/resource-bundles/update create mode 100644 gcloud/alpha/container/fleet/packages/rollouts/abort create mode 100644 gcloud/alpha/container/fleet/packages/rollouts/describe create mode 100644 gcloud/alpha/container/fleet/packages/rollouts/help create mode 100644 gcloud/alpha/container/fleet/packages/rollouts/list create mode 100644 gcloud/alpha/container/fleet/packages/rollouts/resume create mode 100644 gcloud/alpha/container/fleet/packages/rollouts/suspend create mode 100644 gcloud/alpha/container/fleet/packages/update create mode 100644 gcloud/alpha/container/hub/packages/create create mode 100644 gcloud/alpha/container/hub/packages/delete create mode 100644 gcloud/alpha/container/hub/packages/describe create mode 100644 gcloud/alpha/container/hub/packages/help create mode 100644 gcloud/alpha/container/hub/packages/list create mode 100644 gcloud/alpha/container/hub/packages/resource-bundles/create create mode 100644 gcloud/alpha/container/hub/packages/resource-bundles/delete create mode 100644 gcloud/alpha/container/hub/packages/resource-bundles/describe create mode 100644 gcloud/alpha/container/hub/packages/resource-bundles/help create mode 100644 gcloud/alpha/container/hub/packages/resource-bundles/list create mode 100644 gcloud/alpha/container/hub/packages/resource-bundles/releases/create create mode 100644 gcloud/alpha/container/hub/packages/resource-bundles/releases/delete create mode 100644 gcloud/alpha/container/hub/packages/resource-bundles/releases/describe create mode 100644 gcloud/alpha/container/hub/packages/resource-bundles/releases/help create mode 100644 gcloud/alpha/container/hub/packages/resource-bundles/releases/list create mode 100644 gcloud/alpha/container/hub/packages/resource-bundles/releases/update create mode 100644 gcloud/alpha/container/hub/packages/resource-bundles/update create mode 100644 gcloud/alpha/container/hub/packages/rollouts/abort create mode 100644 gcloud/alpha/container/hub/packages/rollouts/describe create mode 100644 gcloud/alpha/container/hub/packages/rollouts/help create mode 100644 gcloud/alpha/container/hub/packages/rollouts/list create mode 100644 gcloud/alpha/container/hub/packages/rollouts/resume create mode 100644 gcloud/alpha/container/hub/packages/rollouts/suspend create mode 100644 gcloud/alpha/container/hub/packages/update create mode 100644 gcloud/alpha/dataplex/entries/search create mode 100644 gcloud/alpha/domains/registrations/initiate-push-transfer create mode 100644 gcloud/alpha/domains/registrations/renew-domain create mode 100644 gcloud/alpha/network-services/multicast-consumer-associations/create create mode 100644 gcloud/alpha/network-services/multicast-consumer-associations/delete create mode 100644 gcloud/alpha/network-services/multicast-consumer-associations/describe create mode 100644 gcloud/alpha/network-services/multicast-consumer-associations/help create mode 100644 gcloud/alpha/network-services/multicast-consumer-associations/list create mode 100644 gcloud/alpha/network-services/multicast-domain-activations/create create mode 100644 gcloud/alpha/network-services/multicast-domain-activations/delete create mode 100644 gcloud/alpha/network-services/multicast-domain-activations/describe create mode 100644 gcloud/alpha/network-services/multicast-domain-activations/help create mode 100644 gcloud/alpha/network-services/multicast-domain-activations/list create mode 100644 gcloud/alpha/network-services/multicast-group-consumer-activations/create create mode 100644 gcloud/alpha/network-services/multicast-group-consumer-activations/delete create mode 100644 gcloud/alpha/network-services/multicast-group-consumer-activations/describe create mode 100644 gcloud/alpha/network-services/multicast-group-consumer-activations/help create mode 100644 gcloud/alpha/network-services/multicast-group-consumer-activations/list create mode 100644 gcloud/alpha/network-services/multicast-group-definitions/create create mode 100644 gcloud/alpha/network-services/multicast-group-definitions/delete create mode 100644 gcloud/alpha/network-services/multicast-group-definitions/describe create mode 100644 gcloud/alpha/network-services/multicast-group-definitions/help create mode 100644 gcloud/alpha/network-services/multicast-group-definitions/list create mode 100644 gcloud/alpha/network-services/multicast-groups/create create mode 100644 gcloud/alpha/network-services/multicast-groups/delete create mode 100644 gcloud/alpha/network-services/multicast-groups/describe create mode 100644 gcloud/alpha/network-services/multicast-groups/help create mode 100644 gcloud/alpha/network-services/multicast-groups/list create mode 100644 gcloud/alpha/network-services/route-views/describe create mode 100644 gcloud/alpha/network-services/route-views/help create mode 100644 gcloud/alpha/network-services/route-views/list create mode 100644 gcloud/alpha/spanner/databases/change-quorum create mode 100644 gcloud/artifacts/files/delete create mode 100644 gcloud/beta/domains/registrations/initiate-push-transfer create mode 100644 gcloud/beta/domains/registrations/renew-domain create mode 100644 gcloud/beta/spanner/databases/change-quorum create mode 100644 gcloud/dataplex/entries/search create mode 100644 gcloud/domains/registrations/initiate-push-transfer create mode 100644 gcloud/domains/registrations/renew-domain create mode 100644 gcloud/spanner/databases/change-quorum diff --git a/gcloud/_version b/gcloud/_version index 9aff5e0a4..9fae7dbc2 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,8 +1,8 @@ -Google Cloud SDK 479.0.0 -alpha 2024.05.31 -beta 2024.05.31 +Google Cloud SDK 480.0.0 +alpha 2024.06.07 +beta 2024.06.07 bq 2.1.5 bundled-python3-unix 3.11.8 -core 2024.05.31 +core 2024.06.07 gcloud-crc32c 1.0.0 gsutil 5.29 diff --git a/gcloud/alpha/audit-manager/enrollments/add b/gcloud/alpha/audit-manager/enrollments/add index d1d31576f..99aa81bbc 100644 --- a/gcloud/alpha/audit-manager/enrollments/add +++ b/gcloud/alpha/audit-manager/enrollments/add @@ -3,18 +3,17 @@ NAME SYNOPSIS gcloud alpha audit-manager enrollments add --eligible-gcs-buckets=BUCKET - URI,[BUCKET URI,...] --location=LOCATION - (--folder=FOLDER | --project=PROJECT) [GCLOUD_WIDE_FLAG ...] + URI,[BUCKET URI,...] (--folder=FOLDER | --project=PROJECT) + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Enroll a new scope. EXAMPLES - To enroll a project with ID 123 in the us-central1 region with - gs://test-bucket-1 and gs://my-bucket-2 as eligible storage buckets, run: + To enroll a project with ID 123 with gs://test-bucket-1 and + gs://my-bucket-2 as eligible storage buckets, run: $ gcloud alpha audit-manager enrollments add --project=123 \ - --location=us-central1 \ --eligible-gcs-buckets="gs://test-bucket-1,gs://my-bucket-2" REQUIRED FLAGS @@ -22,9 +21,6 @@ REQUIRED FLAGS Eligible cloud storage buckets where report and evidence can be uploaded. - --location=LOCATION - The location where to enroll. - Exactly one of these must be specified: --folder=FOLDER diff --git a/gcloud/alpha/blockchain-validator/blockchain-validator-configs/create b/gcloud/alpha/blockchain-validator/blockchain-validator-configs/create new file mode 100644 index 000000000..c8cb6a4c8 --- /dev/null +++ b/gcloud/alpha/blockchain-validator/blockchain-validator-configs/create @@ -0,0 +1,290 @@ +NAME + gcloud alpha blockchain-validator blockchain-validator-configs create - + create a blockchain validator configuration + +SYNOPSIS + gcloud alpha blockchain-validator blockchain-validator-configs create + BLOCKCHAIN_VALIDATOR_CONFIG --blockchain-type=BLOCKCHAIN_TYPE + --key-source=KEY_SOURCE --validation-work-enabled [--async] + [--blockchain-node-id=BLOCKCHAIN_NODE_ID] [--labels=[LABELS,...]] + [--location=LOCATION] + [--ethereum-protocol-details-gas-limit=ETHEREUM_PROTOCOL_DETAILS_GAS_LIMIT --ethereum-protocol-details-graffiti=ETHEREUM_PROTOCOL_DETAILS_GRAFFITI --ethereum-protocol-details-suggested-fee-recipient=ETHEREUM_PROTOCOL_DETAILS_SUGGESTED_FEE_RECIPIENT --ethereum-protocol-details-use-block-builder-proposals] + [[--existing-seed-phrase-reference-secret=EXISTING_SEED_PHRASE_REFERENCE_SECRET : --existing-seed-phrase-reference-derivation-index=EXISTING_SEED_PHRASE_REFERENCE_DERIVATION_INDEX] | [--remote-web3-signer-voting-public-key=REMOTE_WEB3_SIGNER_VOTING_PUBLIC_KEY --remote-web3-signer-web3signer-uri=REMOTE_WEB3_SIGNER_WEB3SIGNER_URI : --remote-web3-signer-timeout-duration=REMOTE_WEB3_SIGNER_TIMEOUT_DURATION] | [--seed-phrase-reference-secret=SEED_PHRASE_REFERENCE_SECRET : --seed-phrase-reference-export]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create a blockchain validator configuration on a blockchain node + managed by Blockchain Node Engine. + +EXAMPLES + To create an Ethereum validator configuration my-validator in the project + my-project and location us-central1, using a new seed phrase which is + exported to Secret Manager, and deploy it to the blockchain node my-node, + run: + + $ gcloud alpha blockchain-validator blockchain-validator-configs \ create my-validator --location=us-central1 \ + --project=my-project --validation-work-enabled=false \ + --blockchain-type=ETHEREUM --key-source=SEED_PHRASE_REFERENCE \ + --seed-phrase-reference-secret=projects/my-project/secrets/\ + my-seed-phrase --seed-phrase-reference-export=true \ + --blockchain-node-id=projects/my-project/locations/us-central1/\ + blockchainNodes/my-node + +POSITIONAL ARGUMENTS + BlockchainValidatorConfig resource - Blockchain Validator Config Name The + name of the Blockchain Validator Config. The fully specified name must + have the format + projects/{project}/locations/{location}/blockchainValidatorConfigs/{validator}. + 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 blockchain_validator_config on the command line + with a fully specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + To set the location attribute: + ◆ provide the argument blockchain_validator_config on the command line + with a fully specified name; + ◆ provide the argument --location on the command line. + + This must be specified. + + BLOCKCHAIN_VALIDATOR_CONFIG + ID of the blockchainValidatorConfig or fully qualified identifier for + the blockchainValidatorConfig. + + To set the blockchain_validator_config attribute: + ▸ provide the argument blockchain_validator_config on the command + line. + +REQUIRED FLAGS + --blockchain-type=BLOCKCHAIN_TYPE + The blockchain type of the validator. BLOCKCHAIN_TYPE must be (only one + value is supported): + + ethereum + The blockchain type is Ethereum. + + --key-source=KEY_SOURCE + The source of the voting key for the blockchain validator. KEY_SOURCE + must be one of: + + existing-seed-phrase-reference + Derive voting keys from existing seed material. + remote-web3-signer + The voting key is stored in a remote signing service (Web3Signer) + and signing requests are delegated. + seed-phrase-reference + Derive voting keys from new seed material. + + --validation-work-enabled + True if the blockchain node requests and signs attestations and blocks + on behalf of this validator, false if not. This does NOT define whether + the blockchain expects work to occur, only whether the blockchain node + specified above is carrying out validation tasks. This should be + enabled under normal conditions, but may be useful when migrating + validators to/from Blockchain Node Engine, where the validator may be + paused during the migration. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + Arguments for the blockchain node. + + --blockchain-node-id=BLOCKCHAIN_NODE_ID + The fully qualified name of the blockchain node which carries out + work on behalf of the validator. If not set, the validator must + either be operated outside of Blockchain Validator Manager, or it + will be offline (no attestations or blocks will be produced). If this + node is offline or deleted, the validator will be offline. + + --labels=[LABELS,...] + Labels as key value pairs. + + KEY + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. + + VALUE + Values must contain only hyphens (-), underscores (_), lowercase + characters, and numbers. + + Shorthand Example: + + --labels=string=string + + JSON Example: + + --labels='{"string": "string"}' + + File Example: + + --labels=path_to_file.(yaml|json) + + --location=LOCATION + For resources [blockchainValidatorConfig, secret], provides fallback + value for resource location attribute. When the resource's full URI + path is not provided, location will fallback to this flag value. + + Arguments for the blockchain type details. + + Blockchain validator configuration unique to Ethereum blockchains. + + Arguments for the gas limit. + + --ethereum-protocol-details-gas-limit=ETHEREUM_PROTOCOL_DETAILS_GAS_LIMIT + Optionally requested (not enforced) maximum gas per block. This + is sent to the block builder service, however whether it is + followed depends on the service. This field is only read if the + field use_block_builder_proposals is set to true. If not + specified, the validator client will use a default value. + + Arguments for the graffiti. + + --ethereum-protocol-details-graffiti=ETHEREUM_PROTOCOL_DETAILS_GRAFFITI + Graffiti is a custom string published in blocks proposed by the + validator. This can only be written, as the current value cannot + be read back from the validator client API. See + https://lighthouse-book.sigmaprime.io/graffiti.html for an + example of how this is used. If not set, the validator client's + default is used. If no blockchain node is specified, this has no + effect as no validator client is run. + + --ethereum-protocol-details-suggested-fee-recipient=ETHEREUM_PROTOCOL_DETAILS_SUGGESTED_FEE_RECIPIENT + The Ethereum address to which fee rewards should be sent. This can + only be set when creating the validator. If no blockchain node is + specified for the validator, this has no effect as no validator + client is run. See also + https://lighthouse-book.sigmaprime.io/suggested-fee-recipient.html + for more context. + + Arguments for the use block builder proposals. + + --ethereum-protocol-details-use-block-builder-proposals + Enable use of the external block building services (MEV). + + Arguments for the key source config. + + At most one of these can be specified: + + Location of existing seed material, and derivation path used to generate + the voting key. + + Secret resource - Reference into Secret Manager for where the seed + phrase is stored. 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 --existing-seed-phrase-reference-secret on + the command line with a fully specified name; + ▫ set the property core/project; + ▫ provide the argument --project on the command line. + + To set the location attribute: + ▫ provide the argument --existing-seed-phrase-reference-secret on + the command line with a fully specified name; + ▫ provide the argument --location on the command line. This + resource can be one of the following types: + [blockchainvalidatormanager.projects.locations.secrets, + blockchainvalidatormanager.projects.secrets]. + + This must be specified. + + --existing-seed-phrase-reference-secret=EXISTING_SEED_PHRASE_REFERENCE_SECRET + ID of the secret or fully qualified identifier for the secret. + + To set the secret attribute: + ◇ provide the argument --existing-seed-phrase-reference-secret + on the command line. + + --existing-seed-phrase-reference-derivation-index=EXISTING_SEED_PHRASE_REFERENCE_DERIVATION_INDEX + The index to derive the voting key at, used as part of a derivation + path. The derivation path is built from this as + "m/12381/3600//0/0" See also + https://eips.ethereum.org/EIPS/eip-2334#eth2-specific-parameters + + Configuration to use an external key signing service, such as the + service endpoint. The external key signer is expected to be managed + entirely by the customer. For reference see + https://docs.web3signer.consensys.net/ for details on Web3Signer and + https://docs.web3signer.consensys.net/reference/api/json-rpc for the API + exposed by the external service. + + --remote-web3-signer-voting-public-key=REMOTE_WEB3_SIGNER_VOTING_PUBLIC_KEY + The public key of the validator, as a hexadecimal string prefixed + with "0x". This is used as the identifier for the key when sending + requests to the Web3Signer service. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --remote-web3-signer-web3signer-uri=REMOTE_WEB3_SIGNER_WEB3SIGNER_URI + URI of the Web3Signer service the validator client connects to, to + request signing of attestations, blocks, etc. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + Arguments for the timeout duration. + + --remote-web3-signer-timeout-duration=REMOTE_WEB3_SIGNER_TIMEOUT_DURATION + Timeout for requests to the Web3Signer service. + + Derivation path used to generate the voting key, and optionally Secret + Manager secret to backup the seed phrase to. + + Secret resource - Reference into Secret Manager for where the seed + phrase is stored. 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 --seed-phrase-reference-secret on the + command line with a fully specified name; + ▫ set the property core/project; + ▫ provide the argument --project on the command line. + + To set the location attribute: + ▫ provide the argument --seed-phrase-reference-secret on the + command line with a fully specified name; + ▫ provide the argument --location on the command line. This + resource can be one of the following types: + [blockchainvalidatormanager.projects.locations.secrets, + blockchainvalidatormanager.projects.secrets]. + + This must be specified. + + --seed-phrase-reference-secret=SEED_PHRASE_REFERENCE_SECRET + ID of the secret or fully qualified identifier for the secret. + + To set the secret attribute: + ◇ provide the argument --seed-phrase-reference-secret on the + command line. + + --seed-phrase-reference-export + True to export the seed phrase to Secret Manager. + +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 blockchainvalidatormanager/v1 API. The full + documentation for this API can be found at: + https://cloud.google.com/blockchain-node-engine/docs/create-node-ethereum#validator_configuration + +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-validator/blockchain-validator-configs/delete b/gcloud/alpha/blockchain-validator/blockchain-validator-configs/delete new file mode 100644 index 000000000..e24d56ae5 --- /dev/null +++ b/gcloud/alpha/blockchain-validator/blockchain-validator-configs/delete @@ -0,0 +1,91 @@ +NAME + gcloud alpha blockchain-validator blockchain-validator-configs delete - + delete a single blockchain validator configuration + +SYNOPSIS + gcloud alpha blockchain-validator blockchain-validator-configs delete + (BLOCKCHAIN_VALIDATOR_CONFIG : --location=LOCATION) [--async] + [--request-id=REQUEST_ID] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete a single blockchain validator configuration from a + blockchain node. + +EXAMPLES + To delete a blockchain validator configuration my-validator in the project + my-project and location us-central1 run: + + $ gcloud alpha blockchain-validator blockchain-validator-configs \ delete my-validator --location=us-central1 --project=my-project + +POSITIONAL ARGUMENTS + BlockchainValidatorConfig resource - Name of the 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 blockchain_validator_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. + + BLOCKCHAIN_VALIDATOR_CONFIG + ID of the blockchainValidatorConfig or fully qualified identifier for + the blockchainValidatorConfig. + + To set the blockchain_validator_config attribute: + ▸ provide the argument blockchain_validator_config on the command + line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the blockchainValidatorConfig resource. + + To set the location attribute: + ▸ provide the argument blockchain_validator_config on the command + line with a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --request-id=REQUEST_ID + An optional request ID to identify requests. Specify a unique request + ID so that if you must retry your request, the server will know to + ignore the request if it has already been completed. The server will + guarantee that for at least 60 minutes after the first request. + + For example, consider a situation where you make an initial request and + the request times out. If you make the request again with the same + request ID, the server can check if original operation with the same + request ID was received, and if so, will ignore the second request. + This prevents clients from accidentally creating duplicate commitments. + + The request ID must be a valid UUID with the exception that zero UUID + is not supported (00000000-0000-0000-0000-000000000000). + +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 blockchainvalidatormanager/v1 API. The full + documentation for this API can be found at: + https://cloud.google.com/blockchain-node-engine/docs/create-node-ethereum#validator_configuration + +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-validator/blockchain-validator-configs/describe b/gcloud/alpha/blockchain-validator/blockchain-validator-configs/describe new file mode 100644 index 000000000..d0556f167 --- /dev/null +++ b/gcloud/alpha/blockchain-validator/blockchain-validator-configs/describe @@ -0,0 +1,74 @@ +NAME + gcloud alpha blockchain-validator blockchain-validator-configs describe - + get details of a single blockchain validator configuration + +SYNOPSIS + gcloud alpha blockchain-validator blockchain-validator-configs describe + (BLOCKCHAIN_VALIDATOR_CONFIG : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Get details of a single blockchain validator configuration. + +EXAMPLES + To get the details of a single validator my-validator in the project + my-project and location us-central1 run: + + $ gcloud alpha blockchain-validator blockchain-validator-configs \ describe my-validator --location=us-central1 \ + --project=my-project + +POSITIONAL ARGUMENTS + BlockchainValidatorConfig resource - The resource name of the validator + config. This is derived from the public key, however it is sensitive due + to the inclusion of the project ID in the resource name. e.g. + projects/my-project/locations/us-central1/blockchainValidatorConfigs/0xa75dbe920352d3e91d06bd8cfe8eb678677127f8748854a7a8894e3c121b63169259448a4b63e5cfb992da412ac91c30. + 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 blockchain_validator_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. + + BLOCKCHAIN_VALIDATOR_CONFIG + ID of the blockchainValidatorConfig or fully qualified identifier for + the blockchainValidatorConfig. + + To set the blockchain_validator_config attribute: + ▸ provide the argument blockchain_validator_config on the command + line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the blockchainValidatorConfig resource. + + To set the location attribute: + ▸ provide the argument blockchain_validator_config on the command + line with a fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the blockchainvalidatormanager/v1 API. The full + documentation for this API can be found at: + https://cloud.google.com/blockchain-node-engine/docs/create-node-ethereum#validator_configuration + +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-validator/blockchain-validator-configs/help b/gcloud/alpha/blockchain-validator/blockchain-validator-configs/help new file mode 100644 index 000000000..9defba8c6 --- /dev/null +++ b/gcloud/alpha/blockchain-validator/blockchain-validator-configs/help @@ -0,0 +1,40 @@ +NAME + gcloud alpha blockchain-validator blockchain-validator-configs - manage + blockchain validator configurations + +SYNOPSIS + gcloud alpha blockchain-validator blockchain-validator-configs COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage blockchain validator configurations. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Create a blockchain validator configuration. + + delete + (ALPHA) Delete a single blockchain validator configuration. + + describe + (ALPHA) Get details of a single blockchain validator configuration. + + list + (ALPHA) List blockchain validator configs. + + update + (ALPHA) Update the configuration of a single blockchain validator. + +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-validator/blockchain-validator-configs/list b/gcloud/alpha/blockchain-validator/blockchain-validator-configs/list new file mode 100644 index 000000000..8f2fa8164 --- /dev/null +++ b/gcloud/alpha/blockchain-validator/blockchain-validator-configs/list @@ -0,0 +1,90 @@ +NAME + gcloud alpha blockchain-validator blockchain-validator-configs list - list + blockchain validator configs + +SYNOPSIS + gcloud alpha blockchain-validator blockchain-validator-configs list + --location=LOCATION [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List blockchain validator configs. + +EXAMPLES + To list all blockchain validators in the project my-project and location + us-central1 run: + + $ gcloud alpha blockchain-validator blockchain-validator-configs \ list --location=us-central1 --project=my-project + +REQUIRED FLAGS + Location resource - The location to list blockchain validator + configurations within. 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 blockchainvalidatormanager/v1 API. The full + documentation for this API can be found at: + https://cloud.google.com/blockchain-node-engine/docs/create-node-ethereum#validator_configuration + +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-validator/blockchain-validator-configs/update b/gcloud/alpha/blockchain-validator/blockchain-validator-configs/update new file mode 100644 index 000000000..cca958013 --- /dev/null +++ b/gcloud/alpha/blockchain-validator/blockchain-validator-configs/update @@ -0,0 +1,195 @@ +NAME + gcloud alpha blockchain-validator blockchain-validator-configs update - + update the configuration of a single blockchain validator + +SYNOPSIS + gcloud alpha blockchain-validator blockchain-validator-configs update + (BLOCKCHAIN_VALIDATOR_CONFIG : --location=LOCATION) [--async] + [--blockchain-node-id=BLOCKCHAIN_NODE_ID] + [--ethereum-protocol-details-graffiti=ETHEREUM_PROTOCOL_DETAILS_GRAFFITI] + [--validation-work-enabled] + [--labels=[LABELS,...] + | --update-labels=[UPDATE_LABELS,...] --clear-labels + | --remove-labels=[__REMOVE_LABELS,...]] + [--remote-web3-signer-timeout-duration=REMOTE_WEB3_SIGNER_TIMEOUT_DURATION --remote-web3-signer-web3signer-uri=REMOTE_WEB3_SIGNER_WEB3SIGNER_URI] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Update the configuration of a single blockchain validator. + +EXAMPLES + To enable validation work on a previously disabled blockchain validator + my-validator in the project my-project and location us-central1 run: + + $ gcloud alpha blockchain-validator blockchain-validator-configs \ update my-validator --location=us-central1 \ + --project=my-project --validation-work-enabled=true + +POSITIONAL ARGUMENTS + BlockchainValidatorConfig resource - Blockchain Validator Config Name The + name of the Blockchain Validator Config. The fully specified name must + have the format + projects/{project}/locations/{location}/blockchainValidatorConfigs/{validator}. + 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 blockchain_validator_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. + + BLOCKCHAIN_VALIDATOR_CONFIG + ID of the blockchainValidatorConfig or fully qualified identifier for + the blockchainValidatorConfig. + + To set the blockchain_validator_config attribute: + ▸ provide the argument blockchain_validator_config on the command + line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the blockchainValidatorConfig resource. + + To set the location attribute: + ▸ provide the argument blockchain_validator_config on the command + line with a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + Arguments for the blockchain node. + + --blockchain-node-id=BLOCKCHAIN_NODE_ID + The fully qualified name of the blockchain node which carries out + work on behalf of the validator. If not set, the validator must + either be operated outside of Blockchain Validator Manager, or it + will be offline (no attestations or blocks will be produced). If this + node is offline or deleted, the validator will be offline. + + Arguments for the blockchain type details. + + Blockchain validator configuration unique to Ethereum blockchains. + + Arguments for the graffiti. + + --ethereum-protocol-details-graffiti=ETHEREUM_PROTOCOL_DETAILS_GRAFFITI + Graffiti is a custom string published in blocks proposed by the + validator. This can only be written, as the current value cannot + be read back from the validator client API. See + https://lighthouse-book.sigmaprime.io/graffiti.html for an + example of how this is used. If not set, the validator client's + default is used. If no blockchain node is specified, this has no + effect as no validator client is run. + + --validation-work-enabled + True if the blockchain node requests and signs attestations and blocks + on behalf of this validator, false if not. This does NOT define whether + the blockchain expects work to occur, only whether the blockchain node + specified above is carrying out validation tasks. This should be + enabled under normal conditions, but may be useful when migrating + validators to/from Blockchain Node Engine, where the validator may be + paused during the migration. + + Update labels. + + At most one of these can be specified: + + --labels=[LABELS,...] + Set labels to new value. Labels as key value pairs + + KEY + Keys must start with a lowercase character and contain only + hyphens (-), underscores (_), lowercase characters, and numbers. + + VALUE + Values must contain only hyphens (-), underscores (_), lowercase + characters, and numbers. + + Shorthand Example: + + --labels=string=string + + JSON Example: + + --labels='{"string": "string"}' + + File Example: + + --labels=path_to_file.(yaml|json) + + --update-labels=[UPDATE_LABELS,...] + Update labels value or add key value pair. Labels as key value pairs + + KEY + Keys must start with a lowercase character and contain only + hyphens (-), underscores (_), lowercase characters, and numbers. + + VALUE + Values must contain only hyphens (-), underscores (_), lowercase + characters, and numbers. + + Shorthand Example: + + --update-labels=string=string + + JSON Example: + + --update-labels='{"string": "string"}' + + File Example: + + --update-labels=path_to_file.(yaml|json) + + At most one of these can be specified: + + --clear-labels + Clear labels value and set to empty map. + + --remove-labels=[__REMOVE_LABELS,...] + Remove existing value from map labels. + + Arguments for the key source config. + + Configuration to use an external key signing service, such as the + service endpoint. The external key signer is expected to be managed + entirely by the customer. For reference see + https://docs.web3signer.consensys.net/ for details on Web3Signer and + https://docs.web3signer.consensys.net/reference/api/json-rpc for the API + exposed by the external service. + + Arguments for the timeout duration. + + --remote-web3-signer-timeout-duration=REMOTE_WEB3_SIGNER_TIMEOUT_DURATION + Timeout for requests to the Web3Signer service. + + --remote-web3-signer-web3signer-uri=REMOTE_WEB3_SIGNER_WEB3SIGNER_URI + URI of the Web3Signer service the validator client connects to, to + request signing of attestations, blocks, etc. + +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 blockchainvalidatormanager/v1 API. The full + documentation for this API can be found at: + https://cloud.google.com/blockchain-node-engine/docs/create-node-ethereum#validator_configuration + +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-validator/help b/gcloud/alpha/blockchain-validator/help new file mode 100644 index 000000000..672c8c40e --- /dev/null +++ b/gcloud/alpha/blockchain-validator/help @@ -0,0 +1,31 @@ +NAME + gcloud alpha blockchain-validator - manage blockchain validator + configurations + +SYNOPSIS + gcloud alpha blockchain-validator GROUP [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Configurations can be deployed to blockchain nodes running under + Blockchain Node Engine. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + blockchain-validator-configs + (ALPHA) Manage blockchain validator configurations. + + operations + (ALPHA) Manage Operation resources. + +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-validator/operations/cancel b/gcloud/alpha/blockchain-validator/operations/cancel new file mode 100644 index 000000000..b7c0c2dc1 --- /dev/null +++ b/gcloud/alpha/blockchain-validator/operations/cancel @@ -0,0 +1,65 @@ +NAME + gcloud alpha blockchain-validator operations cancel - cancel operations + +SYNOPSIS + gcloud alpha blockchain-validator operations cancel + (OPERATION : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Cancel an operation + +EXAMPLES + To cancel the operation, run: + + $ gcloud alpha blockchain-validator operations cancel + +POSITIONAL ARGUMENTS + Operation resource - The name of the operation resource to be cancelled. + 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 operation or fully qualified identifier for the 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. + + --location=LOCATION + The location id of the operation resource. + + 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. + +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 blockchainvalidatormanager/v1 API. The full + documentation for this API can be found at: + https://cloud.google.com/blockchain-node-engine/docs/create-node-ethereum#validator_configuration + +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-validator/operations/delete b/gcloud/alpha/blockchain-validator/operations/delete new file mode 100644 index 000000000..ad2c4b9a4 --- /dev/null +++ b/gcloud/alpha/blockchain-validator/operations/delete @@ -0,0 +1,65 @@ +NAME + gcloud alpha blockchain-validator operations delete - delete operations + +SYNOPSIS + gcloud alpha blockchain-validator operations delete + (OPERATION : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete an operation + +EXAMPLES + To delete the operation, run: + + $ gcloud alpha blockchain-validator operations delete + +POSITIONAL ARGUMENTS + Operation resource - The name of the operation resource to be deleted. 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 operation or fully qualified identifier for the 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. + + --location=LOCATION + The location id of the operation resource. + + 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. + +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 blockchainvalidatormanager/v1 API. The full + documentation for this API can be found at: + https://cloud.google.com/blockchain-node-engine/docs/create-node-ethereum#validator_configuration + +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-validator/operations/describe b/gcloud/alpha/blockchain-validator/operations/describe new file mode 100644 index 000000000..9e9e1886b --- /dev/null +++ b/gcloud/alpha/blockchain-validator/operations/describe @@ -0,0 +1,65 @@ +NAME + gcloud alpha blockchain-validator operations describe - describe operations + +SYNOPSIS + gcloud alpha blockchain-validator operations describe + (OPERATION : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe an operation + +EXAMPLES + To describe the operation, run: + + $ gcloud alpha blockchain-validator operations describe + +POSITIONAL ARGUMENTS + Operation resource - The name of the operation 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 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 operation or fully qualified identifier for the 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. + + --location=LOCATION + The location id of the operation resource. + + 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. + +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 blockchainvalidatormanager/v1 API. The full + documentation for this API can be found at: + https://cloud.google.com/blockchain-node-engine/docs/create-node-ethereum#validator_configuration + +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-validator/operations/help b/gcloud/alpha/blockchain-validator/operations/help new file mode 100644 index 000000000..8221cb5a3 --- /dev/null +++ b/gcloud/alpha/blockchain-validator/operations/help @@ -0,0 +1,38 @@ +NAME + gcloud alpha blockchain-validator operations - manage Operation resources + +SYNOPSIS + gcloud alpha blockchain-validator operations COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Operation resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + cancel + (ALPHA) Cancel operations. + + delete + (ALPHA) Delete operations. + + describe + (ALPHA) Describe operations. + + list + (ALPHA) List operations. + + wait + (ALPHA) Wait operations. + +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-validator/operations/list b/gcloud/alpha/blockchain-validator/operations/list new file mode 100644 index 000000000..d8aa43c9f --- /dev/null +++ b/gcloud/alpha/blockchain-validator/operations/list @@ -0,0 +1,86 @@ +NAME + gcloud alpha blockchain-validator operations list - list operations + +SYNOPSIS + gcloud alpha blockchain-validator operations list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List operations + +EXAMPLES + To list all operations, run: + + $ gcloud alpha blockchain-validator operations list + +REQUIRED FLAGS + Location resource - The name of the operation's parent resource. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ 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 blockchainvalidatormanager/v1 API. The full + documentation for this API can be found at: + https://cloud.google.com/blockchain-node-engine/docs/create-node-ethereum#validator_configuration + +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-validator/operations/wait b/gcloud/alpha/blockchain-validator/operations/wait new file mode 100644 index 000000000..c43637330 --- /dev/null +++ b/gcloud/alpha/blockchain-validator/operations/wait @@ -0,0 +1,65 @@ +NAME + gcloud alpha blockchain-validator operations wait - wait operations + +SYNOPSIS + gcloud alpha blockchain-validator operations wait + (OPERATION : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Wait an operation + +EXAMPLES + To wait the operation, run: + + $ gcloud alpha blockchain-validator operations wait + +POSITIONAL ARGUMENTS + Operation resource - The name of the operation resource to wait on. 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 operation or fully qualified identifier for the 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. + + --location=LOCATION + The location id of the operation resource. + + 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. + +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 blockchainvalidatormanager/v1 API. The full + documentation for this API can be found at: + https://cloud.google.com/blockchain-node-engine/docs/create-node-ethereum#validator_configuration + +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/backend-services/create b/gcloud/alpha/compute/backend-services/create index 060de5870..9b9d69301 100644 --- a/gcloud/alpha/compute/backend-services/create +++ b/gcloud/alpha/compute/backend-services/create @@ -527,17 +527,26 @@ FLAGS If the load-balancing-scheme is INTERNAL_MANAGED (Internal Application Load Balancer), the protocol must be one of: HTTP, HTTPS, HTTP2. + If the load-balancing-scheme is INTERNAL_MANAGED (Internal proxy + Network Load Balancer), the protocol must be only TCP. + If the load-balancing-scheme is EXTERNAL and region is not set (Classic - Application Load Balancer and global external proxy Network Load - Balancer), the protocol must be one of: HTTP, HTTPS, HTTP2, SSL, TCP. + Application Load Balancer and Classic proxy Network Load Balancer), the + protocol must be one of: HTTP, HTTPS, HTTP2, TCP, SSL. If the load-balancing-scheme is EXTERNAL and region is set (External passthrough Network Load Balancer), the protocol must be one of: TCP, UDP, UNSPECIFIED. - If the load-balancing-scheme is EXTERNAL_MANAGED (Envoy based Global - and regional external Application Load Balancers), the protocol must be - one of: HTTP, HTTPS, HTTP2. + If the load-balancing-scheme is EXTERNAL_MANAGED (Global external + Application Load Balancer and regional external Application Load + Balancer), the protocol must be one of: HTTP, HTTPS, HTTP2. + + If the load-balancing-scheme is EXTERNAL_MANAGED (Global external proxy + Network Load Balancer), the protocol must be one of: TCP, SSL. + + If the load-balancing-scheme is EXTERNAL_MANAGED (Regional external + proxy Network Load Balancer), the protocol must be only TCP. --[no-]request-coalescing Enables request coalescing to the backend (recommended). diff --git a/gcloud/alpha/compute/backend-services/update b/gcloud/alpha/compute/backend-services/update index 7bf0b9ee3..b125db617 100644 --- a/gcloud/alpha/compute/backend-services/update +++ b/gcloud/alpha/compute/backend-services/update @@ -366,17 +366,26 @@ FLAGS If the load-balancing-scheme is INTERNAL_MANAGED (Internal Application Load Balancer), the protocol must be one of: HTTP, HTTPS, HTTP2. + If the load-balancing-scheme is INTERNAL_MANAGED (Internal proxy + Network Load Balancer), the protocol must be only TCP. + If the load-balancing-scheme is EXTERNAL and region is not set (Classic - Application Load Balancer and global external proxy Network Load - Balancer), the protocol must be one of: HTTP, HTTPS, HTTP2, SSL, TCP. + Application Load Balancer and Classic proxy Network Load Balancer), the + protocol must be one of: HTTP, HTTPS, HTTP2, TCP, SSL. If the load-balancing-scheme is EXTERNAL and region is set (External passthrough Network Load Balancer), the protocol must be one of: TCP, UDP, UNSPECIFIED. - If the load-balancing-scheme is EXTERNAL_MANAGED (Envoy based Global - and regional external Application Load Balancers), the protocol must be - one of: HTTP, HTTPS, HTTP2. + If the load-balancing-scheme is EXTERNAL_MANAGED (Global external + Application Load Balancer and regional external Application Load + Balancer), the protocol must be one of: HTTP, HTTPS, HTTP2. + + If the load-balancing-scheme is EXTERNAL_MANAGED (Global external proxy + Network Load Balancer), the protocol must be one of: TCP, SSL. + + If the load-balancing-scheme is EXTERNAL_MANAGED (Regional external + proxy Network Load Balancer), the protocol must be only TCP. --[no-]request-coalescing Enables request coalescing to the backend (recommended). diff --git a/gcloud/alpha/compute/commitments/create b/gcloud/alpha/compute/commitments/create index 48dda02c3..5b46e23fb 100644 --- a/gcloud/alpha/compute/commitments/create +++ b/gcloud/alpha/compute/commitments/create @@ -235,14 +235,13 @@ OPTIONAL FLAGS --share-setting=SHARE_SETTING Specify if this reservation is shared, and if so, the type of sharing. If you omit this flag, this value is local (not shared) - by default. SHARE_SETTING must be one of: local, projects, - folders. + by default. SHARE_SETTING must be one of: local, projects. --share-with=SHARE_WITH,[SHARE_WITH,...] If this reservation is shared (--share-setting is not local), - provide a list of all of the specific projects or folders that - this reservation is shared with. List must contain project IDs or - project numbers or folder IDs. + provide a list of all of the specific projects that this + reservation is shared with. List must contain project IDs or + project numbers. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/compute/commitments/update-reservations b/gcloud/alpha/compute/commitments/update-reservations index c7f87f1de..9309bf2c9 100644 --- a/gcloud/alpha/compute/commitments/update-reservations +++ b/gcloud/alpha/compute/commitments/update-reservations @@ -156,14 +156,13 @@ FLAGS --dest-share-setting=DEST_SHARE_SETTING Specify if this reservation is shared, and if so, the type of sharing. If you omit this flag, this value is local (not shared) by - default. DEST_SHARE_SETTING must be one of: local, projects, - folders. + default. DEST_SHARE_SETTING must be one of: local, projects. --dest-share-with=SHARE_WITH,[SHARE_WITH,...] If this reservation is shared (--share-setting is not local), - provide a list of all of the specific projects or folders that this + provide a list of all of the specific projects that this reservation is shared with. List must contain project IDs or - project numbers or folder IDs. + project numbers. --source-accelerator=[count=COUNT],[type=TYPE] Manage the configuration of the type and number of accelerator @@ -192,14 +191,13 @@ FLAGS --source-share-setting=SOURCE_SHARE_SETTING Specify if this reservation is shared, and if so, the type of sharing. If you omit this flag, this value is local (not shared) by - default. SOURCE_SHARE_SETTING must be one of: local, projects, - folders. + default. SOURCE_SHARE_SETTING must be one of: local, projects. --source-share-with=SHARE_WITH,[SHARE_WITH,...] If this reservation is shared (--share-setting is not local), - provide a list of all of the specific projects or folders that this + provide a list of all of the specific projects that this reservation is shared with. List must contain project IDs or - project numbers or folder IDs. + project numbers. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/compute/disks/create b/gcloud/alpha/compute/disks/create index ec05060be..9457ce129 100644 --- a/gcloud/alpha/compute/disks/create +++ b/gcloud/alpha/compute/disks/create @@ -63,8 +63,12 @@ POSITIONAL ARGUMENTS FLAGS --access-mode=ACCESS_MODE - Specifies the access mode that the disk can support. ACCESS_MODE must - be one of: READ_ONLY_MANY, READ_WRITE_MANY, READ_WRITE_SINGLE. + Specifie how VMs attached to the disk can access the data on the disk. + To grant read-only access to multiple VMs attached to the disk, set + access-mode to READ_ONLY_MANY. To grant read-write access to only one + VM attached to the disk, use READ_WRITE_SINGLE. READ_WRITE_SINGLE is + used if omitted. ACCESS_MODE must be one of: READ_ONLY_MANY, + READ_WRITE_MANY, READ_WRITE_SINGLE. --architecture=ARCHITECTURE Specifies the architecture or processor type that this disk can diff --git a/gcloud/alpha/compute/disks/update b/gcloud/alpha/compute/disks/update index e30489336..a0b4a9e89 100644 --- a/gcloud/alpha/compute/disks/update +++ b/gcloud/alpha/compute/disks/update @@ -41,8 +41,12 @@ POSITIONAL ARGUMENTS FLAGS --access-mode=ACCESS_MODE - Specifies the access mode that the disk can support. ACCESS_MODE must - be one of: READ_ONLY_MANY, READ_WRITE_MANY, READ_WRITE_SINGLE. + Specifie how VMs attached to the disk can access the data on the disk. + To grant read-only access to multiple VMs attached to the disk, set + access-mode to READ_ONLY_MANY. To grant read-write access to only one + VM attached to the disk, use READ_WRITE_SINGLE. READ_WRITE_SINGLE is + used if omitted. ACCESS_MODE must be one of: READ_ONLY_MANY, + READ_WRITE_MANY, READ_WRITE_SINGLE. --provisioned-iops=PROVISIONED_IOPS Provisioned IOPS of disk to update. Only for use with disks of type diff --git a/gcloud/alpha/compute/images/import b/gcloud/alpha/compute/images/import index 765588e6d..052f08b5b 100644 --- a/gcloud/alpha/compute/images/import +++ b/gcloud/alpha/compute/images/import @@ -23,6 +23,9 @@ DESCRIPTION (ALPHA) gcloud alpha compute images import imports Virtual Disk images, such as VMWare VMDK files and VHD files, into Compute Engine. + NOTE: It is recommended to use the new Image Import. Run "gcloud alpha + migration vms image-imports --help" for details. + Importing images involves four steps: ▪ Upload the virtual disk file to Cloud Storage. ▪ Import the image to Compute Engine. @@ -47,6 +50,15 @@ DESCRIPTION See https://cloud.google.com/compute/docs/images/importing-virtual-disks#resource_cleanup. + Troubleshooting: Image import/export tools rely on CloudBuild default + behavior. They has been using the default CloudBuild service account in + order to import/export images to/from Google Cloud Platform. However, Cloud + Build has changed this default behavior and in new projects a custom user + managed service account may need to be provided to perform the builds. If + you get a CloudBuild service account related error, run gcloud with + --cloudbuild-service-account=. See gcloud compute + images import --help for details. + EXAMPLES To import a centos-7 VMDK file, run: diff --git a/gcloud/alpha/compute/instances/ops-agents/policies/create b/gcloud/alpha/compute/instances/ops-agents/policies/create index 32fa80256..353467e00 100644 --- a/gcloud/alpha/compute/instances/ops-agents/policies/create +++ b/gcloud/alpha/compute/instances/ops-agents/policies/create @@ -248,6 +248,7 @@ REQUIRED FLAGS ubuntu 22.04 ubuntu 23.04 ubuntu 23.10 + ubuntu 24.04 windows 10.* windows 6.* diff --git a/gcloud/alpha/compute/instances/ops-agents/policies/update b/gcloud/alpha/compute/instances/ops-agents/policies/update index 0851968a1..db64b95f3 100644 --- a/gcloud/alpha/compute/instances/ops-agents/policies/update +++ b/gcloud/alpha/compute/instances/ops-agents/policies/update @@ -285,6 +285,7 @@ FLAGS ubuntu 22.04 ubuntu 23.04 ubuntu 23.10 + ubuntu 24.04 windows 10.* windows 6.* diff --git a/gcloud/alpha/compute/network-endpoint-groups/create b/gcloud/alpha/compute/network-endpoint-groups/create index df88d6736..4fb91ffc7 100644 --- a/gcloud/alpha/compute/network-endpoint-groups/create +++ b/gcloud/alpha/compute/network-endpoint-groups/create @@ -4,7 +4,6 @@ NAME SYNOPSIS gcloud alpha compute network-endpoint-groups create NAME - [--client-port-mapping-mode=CLIENT_PORT_MAPPING_MODE] [--default-port=DEFAULT_PORT] [--network=NETWORK] [--network-endpoint-type=NETWORK_ENDPOINT_TYPE; default="gce-vm-ip-port"] [--producer-port=PRODUCER_PORT] @@ -36,17 +35,6 @@ POSITIONAL ARGUMENTS Name of the network endpoint group to operate on. FLAGS - --client-port-mapping-mode=CLIENT_PORT_MAPPING_MODE - Determines the spec of client port maping mode of this group. Port - Mapping is a use case in which NEG specifies routing by mapping client - ports to destinations (e.g. ip and port). - - port-mapping-disabled - Group should not be used for mapping client port to destination. - - client-port-per-endpoint - For each endpoint there is exactly one client port. - --default-port=DEFAULT_PORT The default port to use if the port number is not specified in the network endpoint. @@ -125,10 +113,10 @@ FLAGS must not be specified. gce-vm-ip-portmap - Endpoint IP address must belong to a VM in Compute Engine (either - the primary IP or as part of an aliased IP range). The - --default-port must be specified or every network endpoint in the - network endpoint group must have a port and client-port specified. + Endpoint IP address must be a primary IP of a VM's network + interface in Compute Engine. The --default-port must be specified + or every network endpoint in the network endpoint group must have a + port specified. NETWORK_ENDPOINT_TYPE must be one of: gce-vm-ip-port, internet-ip-port, internet-fqdn-port, non-gcp-private-ip-port, diff --git a/gcloud/alpha/compute/network-endpoint-groups/update b/gcloud/alpha/compute/network-endpoint-groups/update index 0c278c330..15c41e622 100644 --- a/gcloud/alpha/compute/network-endpoint-groups/update +++ b/gcloud/alpha/compute/network-endpoint-groups/update @@ -5,10 +5,8 @@ NAME SYNOPSIS gcloud alpha compute network-endpoint-groups update NAME (--add-endpoint=[client-destination-port=CLIENT-DESTINATION-PORT], - [client-port=CLIENT-PORT], [fqdn=FQDN],[instance=INSTANCE],[ip=IP],[ipv6=IPV6],[port=PORT] | --remove-endpoint=[client-destination-port=CLIENT-DESTINATION-PORT], - [client-port=CLIENT-PORT], [fqdn=FQDN],[instance=INSTANCE],[ip=IP],[ipv6=IPV6],[port=PORT]) [--global | --region=REGION | --zone=ZONE] [GCLOUD_WIDE_FLAG ...] @@ -40,7 +38,7 @@ REQUIRED FLAGS Exactly one of these must be specified: - --add-endpoint=[client-destination-port=CLIENT-DESTINATION-PORT],[client-port=CLIENT-PORT],[fqdn=FQDN],[instance=INSTANCE],[ip=IP],[ipv6=IPV6],[port=PORT] + --add-endpoint=[client-destination-port=CLIENT-DESTINATION-PORT],[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. @@ -131,7 +129,7 @@ REQUIRED FLAGS IP address must be the VM's network interface address. If not specified, the primary NIC address is used. - --remove-endpoint=[client-destination-port=CLIENT-DESTINATION-PORT],[client-port=CLIENT-PORT],[fqdn=FQDN],[instance=INSTANCE],[ip=IP],[ipv6=IPV6],[port=PORT] + --remove-endpoint=[client-destination-port=CLIENT-DESTINATION-PORT],[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. diff --git a/gcloud/alpha/compute/reservations/update b/gcloud/alpha/compute/reservations/update index 40f8cdbe8..8c9bba647 100644 --- a/gcloud/alpha/compute/reservations/update +++ b/gcloud/alpha/compute/reservations/update @@ -61,9 +61,8 @@ FLAGS --share-with=SHARE_WITH,[SHARE_WITH,...] If this reservation is shared (--share-setting is not local), provide a - list of all of the specific projects or folders that this reservation - is shared with. List must contain project IDs or project numbers or - folder IDs. + list of all of the specific projects that this reservation is shared + with. List must contain project IDs or project numbers. --vm-count=VM_COUNT The number of VM instances that are allocated to this reservation. The diff --git a/gcloud/alpha/container/fleet/help b/gcloud/alpha/container/fleet/help index 560ee9e97..a42ced9a1 100644 --- a/gcloud/alpha/container/fleet/help +++ b/gcloud/alpha/container/fleet/help @@ -85,6 +85,9 @@ GROUPS operations (ALPHA) Manage Anthos fleet long-running operations. + packages + (ALPHA) Manage Fleet Packages resources. + policycontroller (ALPHA) Manage Policy Controller Feature. diff --git a/gcloud/alpha/container/fleet/memberships/get-credentials b/gcloud/alpha/container/fleet/memberships/get-credentials index bb402e2ff..27b96eb28 100644 --- a/gcloud/alpha/container/fleet/memberships/get-credentials +++ b/gcloud/alpha/container/fleet/memberships/get-credentials @@ -59,7 +59,7 @@ POSITIONAL ARGUMENTS --location=LOCATION The location of the membership resource, e.g. us-central1. If not - specified, defaults to global. + specified, attempts to automatically choose the correct region. To set the location attribute: ▸ provide the argument MEMBERSHIP_NAME on the command line with a diff --git a/gcloud/alpha/container/fleet/packages/create b/gcloud/alpha/container/fleet/packages/create new file mode 100644 index 000000000..7806a77ac --- /dev/null +++ b/gcloud/alpha/container/fleet/packages/create @@ -0,0 +1,42 @@ +NAME + gcloud alpha container fleet packages create - create Package Rollouts + Fleet Package + +SYNOPSIS + gcloud alpha container fleet packages create NAME [--location=LOCATION] + [--source=SOURCE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create Package Rollouts Fleet Package. + +EXAMPLES + To create Fleet Package cert-manager-app, run: + + $ gcloud alpha container fleet packages create cert-manager-app \ + --source=source.yaml + +POSITIONAL ARGUMENTS + NAME + Resource name. + +FLAGS + --location=LOCATION + Google Cloud zone or region. + + --source=SOURCE + Source file containing Fleet Package configuration. + +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/fleet/packages/delete b/gcloud/alpha/container/fleet/packages/delete new file mode 100644 index 000000000..c11d1f8c8 --- /dev/null +++ b/gcloud/alpha/container/fleet/packages/delete @@ -0,0 +1,68 @@ +NAME + gcloud alpha container fleet packages delete - delete Package Rollouts + Fleet Package + +SYNOPSIS + gcloud alpha container fleet packages delete + (FLEET_PACKAGE : --location=LOCATION) [--force] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete Package Rollouts Fleet Package. + +EXAMPLES + To delete Fleet Package cert-manager-app in us-central1, run: + + $ gcloud alpha container fleet packages delete cert-manager-app \ + --location=us-central1 + +POSITIONAL ARGUMENTS + Fleet package resource - The Fleet Package 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 fleet_package on the command line with a fully + specified name; + ◆ set the property core/project. + + This must be specified. + + FLEET_PACKAGE + ID of the fleet-package or fully qualified identifier for the + fleet-package. + + To set the fleet-package attribute: + ▸ provide the argument fleet_package on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud zone or region for the fleet-package. + + To set the location attribute: + ▸ provide the argument fleet_package on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property config_delivery/location. + +FLAGS + --force + Force deletion of the Fleet Package and Releases of its Resource + Bundle. + +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/fleet/packages/describe b/gcloud/alpha/container/fleet/packages/describe new file mode 100644 index 000000000..b57914703 --- /dev/null +++ b/gcloud/alpha/container/fleet/packages/describe @@ -0,0 +1,68 @@ +NAME + gcloud alpha container fleet packages describe - describe Package Rollouts + Fleet Package + +SYNOPSIS + gcloud alpha container fleet packages describe + (FLEET_PACKAGE : --location=LOCATION) [--show-cluster-status] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe Package Rollouts Fleet Package. + +EXAMPLES + To view Fleet Package cert-manager-app in us-central1, run: + + $ gcloud alpha container fleet packages describe cert-manager-app \ + --location=us-central1 + +POSITIONAL ARGUMENTS + Fleet package resource - The Fleet Package 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 fleet_package on the command line with a fully + specified name; + ◆ set the property core/project. + + This must be specified. + + FLEET_PACKAGE + ID of the fleet-package or fully qualified identifier for the + fleet-package. + + To set the fleet-package attribute: + ▸ provide the argument fleet_package on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud zone or region for the fleet-package. + + To set the location attribute: + ▸ provide the argument fleet_package on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property config_delivery/location. + +FLAGS + --show-cluster-status + Show more information about the Fleet Package. + +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/fleet/packages/help b/gcloud/alpha/container/fleet/packages/help new file mode 100644 index 000000000..646ba04ec --- /dev/null +++ b/gcloud/alpha/container/fleet/packages/help @@ -0,0 +1,48 @@ +NAME + gcloud alpha container fleet packages - manage Fleet Packages resources + +SYNOPSIS + gcloud alpha container fleet packages GROUP | COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Fleet Packages resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + resource-bundles + (ALPHA) Commands for managing Package Rollouts Resource Bundles. + + rollouts + (ALPHA) Commands for managing Rollouts. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Create Package Rollouts Fleet Package. + + delete + (ALPHA) Delete Package Rollouts Fleet Package. + + describe + (ALPHA) Describe Package Rollouts Fleet Package. + + list + (ALPHA) List Package Rollouts Fleet Packages. + + update + (ALPHA) Update Package Rollouts Fleet Package. + +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/fleet/packages/list b/gcloud/alpha/container/fleet/packages/list new file mode 100644 index 000000000..118eb5689 --- /dev/null +++ b/gcloud/alpha/container/fleet/packages/list @@ -0,0 +1,67 @@ +NAME + gcloud alpha container fleet packages list - list Package Rollouts Fleet + Packages + +SYNOPSIS + gcloud alpha container fleet packages list [--location=LOCATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List Package Rollouts Fleet Packages. + +EXAMPLES + To list all Fleet Packages in us-central1, run: + + $ gcloud alpha container fleet packages list --location=us-central1 + +FLAGS + --location=LOCATION + Google Cloud zone or region. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/container/fleet/packages/resource-bundles/create b/gcloud/alpha/container/fleet/packages/resource-bundles/create new file mode 100644 index 000000000..9061f0c9c --- /dev/null +++ b/gcloud/alpha/container/fleet/packages/resource-bundles/create @@ -0,0 +1,43 @@ +NAME + gcloud alpha container fleet packages resource-bundles create - create + Package Rollouts Resource Bundle + +SYNOPSIS + gcloud alpha container fleet packages resource-bundles create NAME + [--description=DESCRIPTION] [--location=LOCATION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create Package Rollouts Resource Bundle. + +EXAMPLES + To create Resource Bundle cert-manager in us-central1, run: + + $ gcloud alpha container fleet packages resource-bundles create \ + cert-manager --location=us-central1 + +POSITIONAL ARGUMENTS + NAME + Resource name. + +FLAGS + --description=DESCRIPTION + Resource description. + + --location=LOCATION + Google Cloud zone or region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/container/fleet/packages/resource-bundles/delete b/gcloud/alpha/container/fleet/packages/resource-bundles/delete new file mode 100644 index 000000000..8105f5ba1 --- /dev/null +++ b/gcloud/alpha/container/fleet/packages/resource-bundles/delete @@ -0,0 +1,44 @@ +NAME + gcloud alpha container fleet packages resource-bundles delete - delete + Package Rollouts Resource Bundle + +SYNOPSIS + gcloud alpha container fleet packages resource-bundles delete NAME + [--force] [--location=LOCATION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete Package Rollouts Resource Bundle. + +EXAMPLES + To delete Resource Bundle cert-manager in us-central1, run: + + $ gcloud alpha container fleet packages resource-bundles delete \ + cert-manager --location=us-central1 + +POSITIONAL ARGUMENTS + NAME + Resource name. + +FLAGS + --force + If set to true, any releases of this Resource Bundle will also be + deleted. (Otherwise, the request will only work if the Resource Bundle + has no releases.) + + --location=LOCATION + Google Cloud zone or region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/container/fleet/packages/resource-bundles/describe b/gcloud/alpha/container/fleet/packages/resource-bundles/describe new file mode 100644 index 000000000..f82db0635 --- /dev/null +++ b/gcloud/alpha/container/fleet/packages/resource-bundles/describe @@ -0,0 +1,39 @@ +NAME + gcloud alpha container fleet packages resource-bundles describe - describe + Package Rollouts Resource Bundle + +SYNOPSIS + gcloud alpha container fleet packages resource-bundles describe NAME + [--location=LOCATION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe Package Rollouts Resource Bundle. + +EXAMPLES + To describe Resource Bundle cert-manager in us-central1, run: + + $ gcloud alpha container fleet packages resource-bundles describe \ + cert-manager --location=us-central1 + +POSITIONAL ARGUMENTS + NAME + Resource name. + +FLAGS + --location=LOCATION + Google Cloud zone or region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/container/fleet/packages/resource-bundles/help b/gcloud/alpha/container/fleet/packages/resource-bundles/help new file mode 100644 index 000000000..7c8413116 --- /dev/null +++ b/gcloud/alpha/container/fleet/packages/resource-bundles/help @@ -0,0 +1,47 @@ +NAME + gcloud alpha container fleet packages resource-bundles - commands for + managing Package Rollouts Resource Bundles + +SYNOPSIS + gcloud alpha container fleet packages resource-bundles GROUP | COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) See gcloud alpha container fleet packages resource-bundles --help + for help. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + releases + (ALPHA) Commands for managing Package Rollouts Releases. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Create Package Rollouts Resource Bundle. + + delete + (ALPHA) Delete Package Rollouts Resource Bundle. + + describe + (ALPHA) Describe Package Rollouts Resource Bundle. + + list + (ALPHA) List Package Rollouts Resource Bundles. + + update + (ALPHA) Update Package Rollouts Resource Bundle. + +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/fleet/packages/resource-bundles/list b/gcloud/alpha/container/fleet/packages/resource-bundles/list new file mode 100644 index 000000000..354107ee9 --- /dev/null +++ b/gcloud/alpha/container/fleet/packages/resource-bundles/list @@ -0,0 +1,69 @@ +NAME + gcloud alpha container fleet packages resource-bundles list - list Package + Rollouts Resource Bundles + +SYNOPSIS + gcloud alpha container fleet packages resource-bundles list + [--location=LOCATION] [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List Package Rollouts Resource Bundles. + +EXAMPLES + To list Resource Bundles in us-central1, run: + + $ gcloud alpha container fleet packages resource-bundles list \ + --location=us-central1 + +FLAGS + --location=LOCATION + Google Cloud zone or region. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/container/fleet/packages/resource-bundles/releases/create b/gcloud/alpha/container/fleet/packages/resource-bundles/releases/create new file mode 100644 index 000000000..3b07548de --- /dev/null +++ b/gcloud/alpha/container/fleet/packages/resource-bundles/releases/create @@ -0,0 +1,72 @@ +NAME + gcloud alpha container fleet packages resource-bundles releases create - + create Package Rollouts Release + +SYNOPSIS + gcloud alpha container fleet packages resource-bundles releases create + --resource-bundle=RESOURCE_BUNDLE --source=SOURCE --version=VERSION + [--lifecycle=LIFECYCLE] [--location=LOCATION] + [--variants-pattern=VARIANTS_PATTERN] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create Package Rollouts Release. + +EXAMPLES + To create Release v1.0.0 for Resource Bundle my-bundle in us-central1, run: + + $ gcloud alpha container fleet packages resource-bundles releases \ + create --version=v1.0.0 --resource-bundle=my-bundle \ + --source=manifest.yaml + + To create a Release with multiple variants in one directory, run: + + $ gcloud alpha container fleet packages resource-bundles releases \ + create --version=v1.0.0 --resource-bundle=my-bundle \ + --source=/manifests/ --variants-pattern=manifest-*.yaml + + To create a Release with multiple variants across multiple directories, ex: + + $ gcloud alpha container fleet packages resource-bundles releases \ + create --version=v1.0.0 --resource-bundle=my-bundle \ + --source=/manifests/ --variants-pattern=dir-*/ + +REQUIRED FLAGS + --resource-bundle=RESOURCE_BUNDLE + Resource Bundle name. + + --source=SOURCE + Source file or directory to create the Release from. e.g. + --source=manifest.yaml, --source=/manifests-dir/ Can optionally be + paired with the --variants-pattern arg to create multiple variants of a + Release. + + --version=VERSION + Version of the Release to create. + +OPTIONAL FLAGS + --lifecycle=LIFECYCLE + Lifecycle of the Release. + + --location=LOCATION + Google Cloud zone or region. + + --variants-pattern=VARIANTS_PATTERN + Glob pattern to Variants of the Release, to be paired with the --source + arg. ex: --source=/manifests-dir/ --variants-pattern=**, + --source=/manifests-dir/ --variants-pattern=us-*.yaml, + --source=/manifests/dir/ --variants-pattern=*/*.yaml + +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/fleet/packages/resource-bundles/releases/delete b/gcloud/alpha/container/fleet/packages/resource-bundles/releases/delete new file mode 100644 index 000000000..7f614b6b4 --- /dev/null +++ b/gcloud/alpha/container/fleet/packages/resource-bundles/releases/delete @@ -0,0 +1,45 @@ +NAME + gcloud alpha container fleet packages resource-bundles releases delete - + delete Package Rollouts Release + +SYNOPSIS + gcloud alpha container fleet packages resource-bundles releases delete + RELEASE --resource-bundle=RESOURCE_BUNDLE [--location=LOCATION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete Package Rollouts Release. + +EXAMPLES + To delete Release v1.0.0 of cert-manager in us-central1, run: + + $ gcloud alpha container fleet packages resource-bundles releases \ + delete v1.0.0 --location=us-central1 \ + --resource-bundle=cert-manager + +POSITIONAL ARGUMENTS + RELEASE + Release identifier, either a version or tag. + +REQUIRED FLAGS + --resource-bundle=RESOURCE_BUNDLE + Resource Bundle name. + +OPTIONAL FLAGS + --location=LOCATION + Google Cloud zone or region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/container/fleet/packages/resource-bundles/releases/describe b/gcloud/alpha/container/fleet/packages/resource-bundles/releases/describe new file mode 100644 index 000000000..a3b164323 --- /dev/null +++ b/gcloud/alpha/container/fleet/packages/resource-bundles/releases/describe @@ -0,0 +1,45 @@ +NAME + gcloud alpha container fleet packages resource-bundles releases describe - + describe Package Rollouts Release + +SYNOPSIS + gcloud alpha container fleet packages resource-bundles releases describe + RELEASE --resource-bundle=RESOURCE_BUNDLE [--location=LOCATION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe Package Rollouts Release. + +EXAMPLES + To view release v1.0.0 of cert-manager in us-central1, run: + + $ gcloud alpha container fleet packages resource-bundles releases \ + describe v1.0.0 --location=us-central1 \ + --resource-bundle=cert-manager + +POSITIONAL ARGUMENTS + RELEASE + Release identifier, either a version or tag. + +REQUIRED FLAGS + --resource-bundle=RESOURCE_BUNDLE + Resource Bundle name. + +OPTIONAL FLAGS + --location=LOCATION + Google Cloud zone or region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/container/fleet/packages/resource-bundles/releases/help b/gcloud/alpha/container/fleet/packages/resource-bundles/releases/help new file mode 100644 index 000000000..c06ddd674 --- /dev/null +++ b/gcloud/alpha/container/fleet/packages/resource-bundles/releases/help @@ -0,0 +1,41 @@ +NAME + gcloud alpha container fleet packages resource-bundles releases - commands + for managing Package Rollouts Releases + +SYNOPSIS + gcloud alpha container fleet packages resource-bundles releases COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) See gcloud alpha container fleet packages resource-bundles releases + --help for help. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Create Package Rollouts Release. + + delete + (ALPHA) Delete Package Rollouts Release. + + describe + (ALPHA) Describe Package Rollouts Release. + + list + (ALPHA) List Releases of a Resource Bundle. + + update + (ALPHA) Update Package Rollouts Release. + +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/fleet/packages/resource-bundles/releases/list b/gcloud/alpha/container/fleet/packages/resource-bundles/releases/list new file mode 100644 index 000000000..525a84f98 --- /dev/null +++ b/gcloud/alpha/container/fleet/packages/resource-bundles/releases/list @@ -0,0 +1,73 @@ +NAME + gcloud alpha container fleet packages resource-bundles releases list - list + Releases of a Resource Bundle + +SYNOPSIS + gcloud alpha container fleet packages resource-bundles releases list + --resource-bundle=RESOURCE_BUNDLE [--location=LOCATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List Releases of a Resource Bundle. + +EXAMPLES + To list all Releases for bundle cert-manager in us-central1, run: + + $ gcloud alpha container fleet packages resource-bundles releases \ + list --resource-bundle=cert-manager --location=us-central1 + +REQUIRED FLAGS + --resource-bundle=RESOURCE_BUNDLE + Resource Bundle name. + +FLAGS + --location=LOCATION + Google Cloud zone or region. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/container/fleet/packages/resource-bundles/releases/update b/gcloud/alpha/container/fleet/packages/resource-bundles/releases/update new file mode 100644 index 000000000..afc39fbd3 --- /dev/null +++ b/gcloud/alpha/container/fleet/packages/resource-bundles/releases/update @@ -0,0 +1,76 @@ +NAME + gcloud alpha container fleet packages resource-bundles releases update - + update Package Rollouts Release + +SYNOPSIS + gcloud alpha container fleet packages resource-bundles releases update + RELEASE --resource-bundle=RESOURCE_BUNDLE [--lifecycle=LIFECYCLE] + [--location=LOCATION] [--source=SOURCE] [--update-mask=UPDATE_MASK] + [--variants-pattern=VARIANTS_PATTERN] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Update Package Rollouts Release. + +EXAMPLES + To update Release v1.0.0 for Resource Bundle my-bundle in us-central1, run: + + $ gcloud alpha container fleet packages resource-bundles releases \ + update --version=v1.0.0 --resource-bundle=my-bundle \ + --source=manifest.yaml + + To update a Release with multiple variants in one directory, run: + + $ gcloud alpha container fleet packages resource-bundles releases \ + update --version=v1.0.0 --resource-bundle=my-bundle \ + --source=/manifests/ --variants-pattern=manifest-*.yaml + + To update a Release with multiple variants across multiple directories, ex: + + $ gcloud alpha container fleet packages resource-bundles releases \ + update --version=v1.0.0 --resource-bundle=my-bundle \ + --source=/manifests/ --variants-pattern=dir-*/ + +POSITIONAL ARGUMENTS + RELEASE + Release identifier, either a version or tag. + +REQUIRED FLAGS + --resource-bundle=RESOURCE_BUNDLE + Resource Bundle name. + +OPTIONAL FLAGS + --lifecycle=LIFECYCLE + Lifecycle of the Release. + + --location=LOCATION + Google Cloud zone or region. + + --source=SOURCE + Source file or directory to update the Release from. e.g. + --source=manifest.yaml, --source=/manifests-dir/ Can optionally be + paired with the --variants-pattern arg to create multiple variants of a + Release. + + --update-mask=UPDATE_MASK + Mask denoting which fields to update. + + --variants-pattern=VARIANTS_PATTERN + Glob pattern to Variants of the Release, to be paired with the --source + arg. ex: --source=/manifests-dir/ --variants-pattern=**, + --source=/manifests-dir/ --variants-pattern=us-*.yaml, + --source=/manifests/dir/ --variants-pattern=*/*.yaml + +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/fleet/packages/resource-bundles/update b/gcloud/alpha/container/fleet/packages/resource-bundles/update new file mode 100644 index 000000000..f173c3c46 --- /dev/null +++ b/gcloud/alpha/container/fleet/packages/resource-bundles/update @@ -0,0 +1,43 @@ +NAME + gcloud alpha container fleet packages resource-bundles update - update + Package Rollouts Resource Bundle + +SYNOPSIS + gcloud alpha container fleet packages resource-bundles update NAME + [--description=DESCRIPTION] [--location=LOCATION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Update Package Rollouts Resource Bundle. + +EXAMPLES + To update Resource Bundle cert-manager in us-central1, run: + + $ gcloud alpha container fleet packages resource-bundles update \ + cert-manager --location=us-central1 ... + +POSITIONAL ARGUMENTS + NAME + Resource name. + +FLAGS + --description=DESCRIPTION + Resource description. + + --location=LOCATION + Google Cloud zone or region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/container/fleet/packages/rollouts/abort b/gcloud/alpha/container/fleet/packages/rollouts/abort new file mode 100644 index 000000000..6c4c728bd --- /dev/null +++ b/gcloud/alpha/container/fleet/packages/rollouts/abort @@ -0,0 +1,74 @@ +NAME + gcloud alpha container fleet packages rollouts abort - abort Rollout + resource + +SYNOPSIS + gcloud alpha container fleet packages rollouts abort + (ROLLOUT : --fleet-package=FLEET_PACKAGE --location=LOCATION) + [--reason=REASON] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Abort Rollout resource. + +EXAMPLES + To abort Rollout 20240318 for cert-manager-app in us-central1, run: + + $ gcloud alpha container fleet packages rollouts abort 20240318 \ + --fleet-package=cert-manager-app --location=us-central1 + +POSITIONAL ARGUMENTS + Rollout resource - The rollout to abort. 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 rollout on the command line with a fully + specified name; + ◆ set the property core/project. + + This must be specified. + + ROLLOUT + ID of the rollout or fully qualified identifier for the rollout. + + To set the rollout attribute: + ▸ provide the argument rollout on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --fleet-package=FLEET_PACKAGE + Fleet Package name. + + To set the fleet-package attribute: + ▸ provide the argument rollout on the command line with a fully + specified name; + ▸ provide the argument --fleet-package on the command line. + + --location=LOCATION + Google Cloud zone or region for the rollout. + + To set the location attribute: + ▸ provide the argument rollout on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property config_delivery/location. + +FLAGS + --reason=REASON + Reason for aborting rollout. + +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/fleet/packages/rollouts/describe b/gcloud/alpha/container/fleet/packages/rollouts/describe new file mode 100644 index 000000000..ff7cf3f61 --- /dev/null +++ b/gcloud/alpha/container/fleet/packages/rollouts/describe @@ -0,0 +1,47 @@ +NAME + gcloud alpha container fleet packages rollouts describe - describe Rollout + resource + +SYNOPSIS + gcloud alpha container fleet packages rollouts describe NAME + --fleet-package=FLEET_PACKAGE [--less] [--location=LOCATION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe Rollout resource. + +EXAMPLES + To view Rollout 20240318 for cert-manager-app in us-central1, run: + + $ gcloud alpha container fleet packages rollouts describe 20240318 \ + --fleet-package=cert-manager-app --location=us-central1 + +POSITIONAL ARGUMENTS + NAME + Resource name. + +REQUIRED FLAGS + --fleet-package=FLEET_PACKAGE + Parent Fleet Package of the Rollout. + +OPTIONAL FLAGS + --less + Show less verbose output. + + --location=LOCATION + Google Cloud zone or region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/container/fleet/packages/rollouts/help b/gcloud/alpha/container/fleet/packages/rollouts/help new file mode 100644 index 000000000..e62409f24 --- /dev/null +++ b/gcloud/alpha/container/fleet/packages/rollouts/help @@ -0,0 +1,40 @@ +NAME + gcloud alpha container fleet packages rollouts - commands for managing + Rollouts + +SYNOPSIS + gcloud alpha container fleet packages rollouts COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) See gcloud alpha container fleet packages rollouts --help for help. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + abort + (ALPHA) Abort Rollout resource. + + describe + (ALPHA) Describe Rollout resource. + + list + (ALPHA) List Rollouts of a Fleet Package. + + resume + (ALPHA) Resume suspended Rollout. + + suspend + (ALPHA) Suspend in-progress Rollout. + +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/fleet/packages/rollouts/list b/gcloud/alpha/container/fleet/packages/rollouts/list new file mode 100644 index 000000000..d8626de8c --- /dev/null +++ b/gcloud/alpha/container/fleet/packages/rollouts/list @@ -0,0 +1,77 @@ +NAME + gcloud alpha container fleet packages rollouts list - list Rollouts of a + Fleet Package + +SYNOPSIS + gcloud alpha container fleet packages rollouts list + --fleet-package=FLEET_PACKAGE [--less] [--location=LOCATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List Rollouts of a Fleet Package. + +EXAMPLES + To list all Rollouts for Fleet Package cert-manager-app in us-central1, + run: + + $ gcloud alpha container fleet packages rollouts list \ + --fleet-package=cert-manager-app --location=us-central1 + +REQUIRED FLAGS + --fleet-package=FLEET_PACKAGE + Parent Fleet Package of the Rollout. + +FLAGS + --less + Show less verbose output. + + --location=LOCATION + Google Cloud zone or region. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/container/fleet/packages/rollouts/resume b/gcloud/alpha/container/fleet/packages/rollouts/resume new file mode 100644 index 000000000..d53cb07b3 --- /dev/null +++ b/gcloud/alpha/container/fleet/packages/rollouts/resume @@ -0,0 +1,74 @@ +NAME + gcloud alpha container fleet packages rollouts resume - resume suspended + Rollout + +SYNOPSIS + gcloud alpha container fleet packages rollouts resume + (ROLLOUT : --fleet-package=FLEET_PACKAGE --location=LOCATION) + [--reason=REASON] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Resume suspended Rollout. + +EXAMPLES + To resume Rollout 20240318 for cert-manager-app in us-central1, run: + + $ gcloud alpha container fleet packages rollouts resume 20240318 \ + --fleet-package=cert-manager-app --location=us-central1 + +POSITIONAL ARGUMENTS + Rollout resource - The rollout to resume. 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 rollout on the command line with a fully + specified name; + ◆ set the property core/project. + + This must be specified. + + ROLLOUT + ID of the rollout or fully qualified identifier for the rollout. + + To set the rollout attribute: + ▸ provide the argument rollout on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --fleet-package=FLEET_PACKAGE + Fleet Package name. + + To set the fleet-package attribute: + ▸ provide the argument rollout on the command line with a fully + specified name; + ▸ provide the argument --fleet-package on the command line. + + --location=LOCATION + Google Cloud zone or region for the rollout. + + To set the location attribute: + ▸ provide the argument rollout on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property config_delivery/location. + +FLAGS + --reason=REASON + Reason for resuming rollout. + +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/fleet/packages/rollouts/suspend b/gcloud/alpha/container/fleet/packages/rollouts/suspend new file mode 100644 index 000000000..61e8ab525 --- /dev/null +++ b/gcloud/alpha/container/fleet/packages/rollouts/suspend @@ -0,0 +1,74 @@ +NAME + gcloud alpha container fleet packages rollouts suspend - suspend + in-progress Rollout + +SYNOPSIS + gcloud alpha container fleet packages rollouts suspend + (ROLLOUT : --fleet-package=FLEET_PACKAGE --location=LOCATION) + [--reason=REASON] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Suspend in-progress Rollout. + +EXAMPLES + To suspend Rollout 20240318 for cert-manager-app in us-central1, run: + + $ gcloud alpha container fleet packages rollouts suspend 20240318 \ + --fleet-package=cert-manager-app --location=us-central1 + +POSITIONAL ARGUMENTS + Rollout resource - The rollout to suspend. 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 rollout on the command line with a fully + specified name; + ◆ set the property core/project. + + This must be specified. + + ROLLOUT + ID of the rollout or fully qualified identifier for the rollout. + + To set the rollout attribute: + ▸ provide the argument rollout on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --fleet-package=FLEET_PACKAGE + Fleet Package name. + + To set the fleet-package attribute: + ▸ provide the argument rollout on the command line with a fully + specified name; + ▸ provide the argument --fleet-package on the command line. + + --location=LOCATION + Google Cloud zone or region for the rollout. + + To set the location attribute: + ▸ provide the argument rollout on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property config_delivery/location. + +FLAGS + --reason=REASON + Reason for suspending rollout. + +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/fleet/packages/update b/gcloud/alpha/container/fleet/packages/update new file mode 100644 index 000000000..5ef397a44 --- /dev/null +++ b/gcloud/alpha/container/fleet/packages/update @@ -0,0 +1,68 @@ +NAME + gcloud alpha container fleet packages update - update Package Rollouts + Fleet Package + +SYNOPSIS + gcloud alpha container fleet packages update + (FLEET_PACKAGE : --location=LOCATION) [--source=SOURCE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Update Package Rollouts Fleet Package. + +EXAMPLES + To update Fleet Package cert-manager-app, run: + + $ gcloud alpha container fleet packages update cert-manager-app \ + --source=my_source.yaml + +POSITIONAL ARGUMENTS + Fleet package resource - The Fleet Package 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 fleet_package on the command line with a fully + specified name; + ◆ set the property core/project. + + This must be specified. + + FLEET_PACKAGE + ID of the fleet-package or fully qualified identifier for the + fleet-package. + + To set the fleet-package attribute: + ▸ provide the argument fleet_package on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud zone or region for the fleet-package. + + To set the location attribute: + ▸ provide the argument fleet_package on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property config_delivery/location. + +FLAGS + --source=SOURCE + Source file containing Fleet Package configuration. + +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/hub/help b/gcloud/alpha/container/hub/help index 2eced656f..e1f3790ad 100644 --- a/gcloud/alpha/container/hub/help +++ b/gcloud/alpha/container/hub/help @@ -85,6 +85,9 @@ GROUPS operations (ALPHA) Manage Anthos fleet long-running operations. + packages + (ALPHA) Manage Fleet Packages resources. + policycontroller (ALPHA) Manage Policy Controller Feature. diff --git a/gcloud/alpha/container/hub/memberships/get-credentials b/gcloud/alpha/container/hub/memberships/get-credentials index 99fb81940..6a9af5044 100644 --- a/gcloud/alpha/container/hub/memberships/get-credentials +++ b/gcloud/alpha/container/hub/memberships/get-credentials @@ -58,7 +58,7 @@ POSITIONAL ARGUMENTS --location=LOCATION The location of the membership resource, e.g. us-central1. If not - specified, defaults to global. + specified, attempts to automatically choose the correct region. To set the location attribute: ▸ provide the argument MEMBERSHIP_NAME on the command line with a diff --git a/gcloud/alpha/container/hub/packages/create b/gcloud/alpha/container/hub/packages/create new file mode 100644 index 000000000..51122e1a7 --- /dev/null +++ b/gcloud/alpha/container/hub/packages/create @@ -0,0 +1,42 @@ +NAME + gcloud alpha container hub packages create - create Package Rollouts Fleet + Package + +SYNOPSIS + gcloud alpha container hub packages create NAME [--location=LOCATION] + [--source=SOURCE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create Package Rollouts Fleet Package. + +EXAMPLES + To create Fleet Package cert-manager-app, run: + + $ gcloud alpha container hub packages create cert-manager-app \ + --source=source.yaml + +POSITIONAL ARGUMENTS + NAME + Resource name. + +FLAGS + --location=LOCATION + Google Cloud zone or region. + + --source=SOURCE + Source file containing Fleet Package configuration. + +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/hub/packages/delete b/gcloud/alpha/container/hub/packages/delete new file mode 100644 index 000000000..8b9a40480 --- /dev/null +++ b/gcloud/alpha/container/hub/packages/delete @@ -0,0 +1,68 @@ +NAME + gcloud alpha container hub packages delete - delete Package Rollouts Fleet + Package + +SYNOPSIS + gcloud alpha container hub packages delete + (FLEET_PACKAGE : --location=LOCATION) [--force] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete Package Rollouts Fleet Package. + +EXAMPLES + To delete Fleet Package cert-manager-app in us-central1, run: + + $ gcloud alpha container hub packages delete cert-manager-app \ + --location=us-central1 + +POSITIONAL ARGUMENTS + Fleet package resource - The Fleet Package 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 fleet_package on the command line with a fully + specified name; + ◆ set the property core/project. + + This must be specified. + + FLEET_PACKAGE + ID of the fleet-package or fully qualified identifier for the + fleet-package. + + To set the fleet-package attribute: + ▸ provide the argument fleet_package on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud zone or region for the fleet-package. + + To set the location attribute: + ▸ provide the argument fleet_package on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property config_delivery/location. + +FLAGS + --force + Force deletion of the Fleet Package and Releases of its Resource + Bundle. + +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/hub/packages/describe b/gcloud/alpha/container/hub/packages/describe new file mode 100644 index 000000000..28fc39482 --- /dev/null +++ b/gcloud/alpha/container/hub/packages/describe @@ -0,0 +1,68 @@ +NAME + gcloud alpha container hub packages describe - describe Package Rollouts + Fleet Package + +SYNOPSIS + gcloud alpha container hub packages describe + (FLEET_PACKAGE : --location=LOCATION) [--show-cluster-status] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe Package Rollouts Fleet Package. + +EXAMPLES + To view Fleet Package cert-manager-app in us-central1, run: + + $ gcloud alpha container hub packages describe cert-manager-app \ + --location=us-central1 + +POSITIONAL ARGUMENTS + Fleet package resource - The Fleet Package 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 fleet_package on the command line with a fully + specified name; + ◆ set the property core/project. + + This must be specified. + + FLEET_PACKAGE + ID of the fleet-package or fully qualified identifier for the + fleet-package. + + To set the fleet-package attribute: + ▸ provide the argument fleet_package on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud zone or region for the fleet-package. + + To set the location attribute: + ▸ provide the argument fleet_package on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property config_delivery/location. + +FLAGS + --show-cluster-status + Show more information about the Fleet Package. + +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/hub/packages/help b/gcloud/alpha/container/hub/packages/help new file mode 100644 index 000000000..c93fbfa82 --- /dev/null +++ b/gcloud/alpha/container/hub/packages/help @@ -0,0 +1,47 @@ +NAME + gcloud alpha container hub packages - manage Fleet Packages resources + +SYNOPSIS + gcloud alpha container hub packages GROUP | COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Fleet Packages resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + resource-bundles + (ALPHA) Commands for managing Package Rollouts Resource Bundles. + + rollouts + (ALPHA) Commands for managing Rollouts. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Create Package Rollouts Fleet Package. + + delete + (ALPHA) Delete Package Rollouts Fleet Package. + + describe + (ALPHA) Describe Package Rollouts Fleet Package. + + list + (ALPHA) List Package Rollouts Fleet Packages. + + update + (ALPHA) Update Package Rollouts Fleet Package. + +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/hub/packages/list b/gcloud/alpha/container/hub/packages/list new file mode 100644 index 000000000..d194b2417 --- /dev/null +++ b/gcloud/alpha/container/hub/packages/list @@ -0,0 +1,67 @@ +NAME + gcloud alpha container hub packages list - list Package Rollouts Fleet + Packages + +SYNOPSIS + gcloud alpha container hub packages list [--location=LOCATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List Package Rollouts Fleet Packages. + +EXAMPLES + To list all Fleet Packages in us-central1, run: + + $ gcloud alpha container hub packages list --location=us-central1 + +FLAGS + --location=LOCATION + Google Cloud zone or region. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/container/hub/packages/resource-bundles/create b/gcloud/alpha/container/hub/packages/resource-bundles/create new file mode 100644 index 000000000..701a5128a --- /dev/null +++ b/gcloud/alpha/container/hub/packages/resource-bundles/create @@ -0,0 +1,43 @@ +NAME + gcloud alpha container hub packages resource-bundles create - create + Package Rollouts Resource Bundle + +SYNOPSIS + gcloud alpha container hub packages resource-bundles create NAME + [--description=DESCRIPTION] [--location=LOCATION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create Package Rollouts Resource Bundle. + +EXAMPLES + To create Resource Bundle cert-manager in us-central1, run: + + $ gcloud alpha container hub packages resource-bundles create \ + cert-manager --location=us-central1 + +POSITIONAL ARGUMENTS + NAME + Resource name. + +FLAGS + --description=DESCRIPTION + Resource description. + + --location=LOCATION + Google Cloud zone or region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/container/hub/packages/resource-bundles/delete b/gcloud/alpha/container/hub/packages/resource-bundles/delete new file mode 100644 index 000000000..57062681b --- /dev/null +++ b/gcloud/alpha/container/hub/packages/resource-bundles/delete @@ -0,0 +1,44 @@ +NAME + gcloud alpha container hub packages resource-bundles delete - delete + Package Rollouts Resource Bundle + +SYNOPSIS + gcloud alpha container hub packages resource-bundles delete NAME [--force] + [--location=LOCATION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete Package Rollouts Resource Bundle. + +EXAMPLES + To delete Resource Bundle cert-manager in us-central1, run: + + $ gcloud alpha container hub packages resource-bundles delete \ + cert-manager --location=us-central1 + +POSITIONAL ARGUMENTS + NAME + Resource name. + +FLAGS + --force + If set to true, any releases of this Resource Bundle will also be + deleted. (Otherwise, the request will only work if the Resource Bundle + has no releases.) + + --location=LOCATION + Google Cloud zone or region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/container/hub/packages/resource-bundles/describe b/gcloud/alpha/container/hub/packages/resource-bundles/describe new file mode 100644 index 000000000..5f65d5aab --- /dev/null +++ b/gcloud/alpha/container/hub/packages/resource-bundles/describe @@ -0,0 +1,39 @@ +NAME + gcloud alpha container hub packages resource-bundles describe - describe + Package Rollouts Resource Bundle + +SYNOPSIS + gcloud alpha container hub packages resource-bundles describe NAME + [--location=LOCATION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe Package Rollouts Resource Bundle. + +EXAMPLES + To describe Resource Bundle cert-manager in us-central1, run: + + $ gcloud alpha container hub packages resource-bundles describe \ + cert-manager --location=us-central1 + +POSITIONAL ARGUMENTS + NAME + Resource name. + +FLAGS + --location=LOCATION + Google Cloud zone or region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/container/hub/packages/resource-bundles/help b/gcloud/alpha/container/hub/packages/resource-bundles/help new file mode 100644 index 000000000..864e652c2 --- /dev/null +++ b/gcloud/alpha/container/hub/packages/resource-bundles/help @@ -0,0 +1,47 @@ +NAME + gcloud alpha container hub packages resource-bundles - commands for + managing Package Rollouts Resource Bundles + +SYNOPSIS + gcloud alpha container hub packages resource-bundles GROUP | COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) See gcloud alpha container fleet packages resource-bundles --help + for help. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + releases + (ALPHA) Commands for managing Package Rollouts Releases. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Create Package Rollouts Resource Bundle. + + delete + (ALPHA) Delete Package Rollouts Resource Bundle. + + describe + (ALPHA) Describe Package Rollouts Resource Bundle. + + list + (ALPHA) List Package Rollouts Resource Bundles. + + update + (ALPHA) Update Package Rollouts Resource Bundle. + +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/hub/packages/resource-bundles/list b/gcloud/alpha/container/hub/packages/resource-bundles/list new file mode 100644 index 000000000..761bb4f11 --- /dev/null +++ b/gcloud/alpha/container/hub/packages/resource-bundles/list @@ -0,0 +1,69 @@ +NAME + gcloud alpha container hub packages resource-bundles list - list Package + Rollouts Resource Bundles + +SYNOPSIS + gcloud alpha container hub packages resource-bundles list + [--location=LOCATION] [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List Package Rollouts Resource Bundles. + +EXAMPLES + To list Resource Bundles in us-central1, run: + + $ gcloud alpha container hub packages resource-bundles list \ + --location=us-central1 + +FLAGS + --location=LOCATION + Google Cloud zone or region. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/container/hub/packages/resource-bundles/releases/create b/gcloud/alpha/container/hub/packages/resource-bundles/releases/create new file mode 100644 index 000000000..5633e2fc6 --- /dev/null +++ b/gcloud/alpha/container/hub/packages/resource-bundles/releases/create @@ -0,0 +1,72 @@ +NAME + gcloud alpha container hub packages resource-bundles releases create - + create Package Rollouts Release + +SYNOPSIS + gcloud alpha container hub packages resource-bundles releases create + --resource-bundle=RESOURCE_BUNDLE --source=SOURCE --version=VERSION + [--lifecycle=LIFECYCLE] [--location=LOCATION] + [--variants-pattern=VARIANTS_PATTERN] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create Package Rollouts Release. + +EXAMPLES + To create Release v1.0.0 for Resource Bundle my-bundle in us-central1, run: + + $ gcloud alpha container hub packages resource-bundles releases \ + create --version=v1.0.0 --resource-bundle=my-bundle \ + --source=manifest.yaml + + To create a Release with multiple variants in one directory, run: + + $ gcloud alpha container hub packages resource-bundles releases \ + create --version=v1.0.0 --resource-bundle=my-bundle \ + --source=/manifests/ --variants-pattern=manifest-*.yaml + + To create a Release with multiple variants across multiple directories, ex: + + $ gcloud alpha container hub packages resource-bundles releases \ + create --version=v1.0.0 --resource-bundle=my-bundle \ + --source=/manifests/ --variants-pattern=dir-*/ + +REQUIRED FLAGS + --resource-bundle=RESOURCE_BUNDLE + Resource Bundle name. + + --source=SOURCE + Source file or directory to create the Release from. e.g. + --source=manifest.yaml, --source=/manifests-dir/ Can optionally be + paired with the --variants-pattern arg to create multiple variants of a + Release. + + --version=VERSION + Version of the Release to create. + +OPTIONAL FLAGS + --lifecycle=LIFECYCLE + Lifecycle of the Release. + + --location=LOCATION + Google Cloud zone or region. + + --variants-pattern=VARIANTS_PATTERN + Glob pattern to Variants of the Release, to be paired with the --source + arg. ex: --source=/manifests-dir/ --variants-pattern=**, + --source=/manifests-dir/ --variants-pattern=us-*.yaml, + --source=/manifests/dir/ --variants-pattern=*/*.yaml + +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/hub/packages/resource-bundles/releases/delete b/gcloud/alpha/container/hub/packages/resource-bundles/releases/delete new file mode 100644 index 000000000..aab7c2022 --- /dev/null +++ b/gcloud/alpha/container/hub/packages/resource-bundles/releases/delete @@ -0,0 +1,45 @@ +NAME + gcloud alpha container hub packages resource-bundles releases delete - + delete Package Rollouts Release + +SYNOPSIS + gcloud alpha container hub packages resource-bundles releases delete + RELEASE --resource-bundle=RESOURCE_BUNDLE [--location=LOCATION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete Package Rollouts Release. + +EXAMPLES + To delete Release v1.0.0 of cert-manager in us-central1, run: + + $ gcloud alpha container hub packages resource-bundles releases \ + delete v1.0.0 --location=us-central1 \ + --resource-bundle=cert-manager + +POSITIONAL ARGUMENTS + RELEASE + Release identifier, either a version or tag. + +REQUIRED FLAGS + --resource-bundle=RESOURCE_BUNDLE + Resource Bundle name. + +OPTIONAL FLAGS + --location=LOCATION + Google Cloud zone or region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/container/hub/packages/resource-bundles/releases/describe b/gcloud/alpha/container/hub/packages/resource-bundles/releases/describe new file mode 100644 index 000000000..7932dc229 --- /dev/null +++ b/gcloud/alpha/container/hub/packages/resource-bundles/releases/describe @@ -0,0 +1,45 @@ +NAME + gcloud alpha container hub packages resource-bundles releases describe - + describe Package Rollouts Release + +SYNOPSIS + gcloud alpha container hub packages resource-bundles releases describe + RELEASE --resource-bundle=RESOURCE_BUNDLE [--location=LOCATION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe Package Rollouts Release. + +EXAMPLES + To view release v1.0.0 of cert-manager in us-central1, run: + + $ gcloud alpha container hub packages resource-bundles releases \ + describe v1.0.0 --location=us-central1 \ + --resource-bundle=cert-manager + +POSITIONAL ARGUMENTS + RELEASE + Release identifier, either a version or tag. + +REQUIRED FLAGS + --resource-bundle=RESOURCE_BUNDLE + Resource Bundle name. + +OPTIONAL FLAGS + --location=LOCATION + Google Cloud zone or region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/container/hub/packages/resource-bundles/releases/help b/gcloud/alpha/container/hub/packages/resource-bundles/releases/help new file mode 100644 index 000000000..021dd2468 --- /dev/null +++ b/gcloud/alpha/container/hub/packages/resource-bundles/releases/help @@ -0,0 +1,41 @@ +NAME + gcloud alpha container hub packages resource-bundles releases - commands + for managing Package Rollouts Releases + +SYNOPSIS + gcloud alpha container hub packages resource-bundles releases COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) See gcloud alpha container fleet packages resource-bundles releases + --help for help. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Create Package Rollouts Release. + + delete + (ALPHA) Delete Package Rollouts Release. + + describe + (ALPHA) Describe Package Rollouts Release. + + list + (ALPHA) List Releases of a Resource Bundle. + + update + (ALPHA) Update Package Rollouts Release. + +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/hub/packages/resource-bundles/releases/list b/gcloud/alpha/container/hub/packages/resource-bundles/releases/list new file mode 100644 index 000000000..49f79b117 --- /dev/null +++ b/gcloud/alpha/container/hub/packages/resource-bundles/releases/list @@ -0,0 +1,73 @@ +NAME + gcloud alpha container hub packages resource-bundles releases list - list + Releases of a Resource Bundle + +SYNOPSIS + gcloud alpha container hub packages resource-bundles releases list + --resource-bundle=RESOURCE_BUNDLE [--location=LOCATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List Releases of a Resource Bundle. + +EXAMPLES + To list all Releases for bundle cert-manager in us-central1, run: + + $ gcloud alpha container hub packages resource-bundles releases \ + list --resource-bundle=cert-manager --location=us-central1 + +REQUIRED FLAGS + --resource-bundle=RESOURCE_BUNDLE + Resource Bundle name. + +FLAGS + --location=LOCATION + Google Cloud zone or region. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/container/hub/packages/resource-bundles/releases/update b/gcloud/alpha/container/hub/packages/resource-bundles/releases/update new file mode 100644 index 000000000..af6829c6c --- /dev/null +++ b/gcloud/alpha/container/hub/packages/resource-bundles/releases/update @@ -0,0 +1,76 @@ +NAME + gcloud alpha container hub packages resource-bundles releases update - + update Package Rollouts Release + +SYNOPSIS + gcloud alpha container hub packages resource-bundles releases update + RELEASE --resource-bundle=RESOURCE_BUNDLE [--lifecycle=LIFECYCLE] + [--location=LOCATION] [--source=SOURCE] [--update-mask=UPDATE_MASK] + [--variants-pattern=VARIANTS_PATTERN] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Update Package Rollouts Release. + +EXAMPLES + To update Release v1.0.0 for Resource Bundle my-bundle in us-central1, run: + + $ gcloud alpha container hub packages resource-bundles releases \ + update --version=v1.0.0 --resource-bundle=my-bundle \ + --source=manifest.yaml + + To update a Release with multiple variants in one directory, run: + + $ gcloud alpha container hub packages resource-bundles releases \ + update --version=v1.0.0 --resource-bundle=my-bundle \ + --source=/manifests/ --variants-pattern=manifest-*.yaml + + To update a Release with multiple variants across multiple directories, ex: + + $ gcloud alpha container hub packages resource-bundles releases \ + update --version=v1.0.0 --resource-bundle=my-bundle \ + --source=/manifests/ --variants-pattern=dir-*/ + +POSITIONAL ARGUMENTS + RELEASE + Release identifier, either a version or tag. + +REQUIRED FLAGS + --resource-bundle=RESOURCE_BUNDLE + Resource Bundle name. + +OPTIONAL FLAGS + --lifecycle=LIFECYCLE + Lifecycle of the Release. + + --location=LOCATION + Google Cloud zone or region. + + --source=SOURCE + Source file or directory to update the Release from. e.g. + --source=manifest.yaml, --source=/manifests-dir/ Can optionally be + paired with the --variants-pattern arg to create multiple variants of a + Release. + + --update-mask=UPDATE_MASK + Mask denoting which fields to update. + + --variants-pattern=VARIANTS_PATTERN + Glob pattern to Variants of the Release, to be paired with the --source + arg. ex: --source=/manifests-dir/ --variants-pattern=**, + --source=/manifests-dir/ --variants-pattern=us-*.yaml, + --source=/manifests/dir/ --variants-pattern=*/*.yaml + +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/hub/packages/resource-bundles/update b/gcloud/alpha/container/hub/packages/resource-bundles/update new file mode 100644 index 000000000..9231dc529 --- /dev/null +++ b/gcloud/alpha/container/hub/packages/resource-bundles/update @@ -0,0 +1,43 @@ +NAME + gcloud alpha container hub packages resource-bundles update - update + Package Rollouts Resource Bundle + +SYNOPSIS + gcloud alpha container hub packages resource-bundles update NAME + [--description=DESCRIPTION] [--location=LOCATION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Update Package Rollouts Resource Bundle. + +EXAMPLES + To update Resource Bundle cert-manager in us-central1, run: + + $ gcloud alpha container hub packages resource-bundles update \ + cert-manager --location=us-central1 ... + +POSITIONAL ARGUMENTS + NAME + Resource name. + +FLAGS + --description=DESCRIPTION + Resource description. + + --location=LOCATION + Google Cloud zone or region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/container/hub/packages/rollouts/abort b/gcloud/alpha/container/hub/packages/rollouts/abort new file mode 100644 index 000000000..083a54220 --- /dev/null +++ b/gcloud/alpha/container/hub/packages/rollouts/abort @@ -0,0 +1,73 @@ +NAME + gcloud alpha container hub packages rollouts abort - abort Rollout resource + +SYNOPSIS + gcloud alpha container hub packages rollouts abort + (ROLLOUT : --fleet-package=FLEET_PACKAGE --location=LOCATION) + [--reason=REASON] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Abort Rollout resource. + +EXAMPLES + To abort Rollout 20240318 for cert-manager-app in us-central1, run: + + $ gcloud alpha container hub packages rollouts abort 20240318 \ + --fleet-package=cert-manager-app --location=us-central1 + +POSITIONAL ARGUMENTS + Rollout resource - The rollout to abort. 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 rollout on the command line with a fully + specified name; + ◆ set the property core/project. + + This must be specified. + + ROLLOUT + ID of the rollout or fully qualified identifier for the rollout. + + To set the rollout attribute: + ▸ provide the argument rollout on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --fleet-package=FLEET_PACKAGE + Fleet Package name. + + To set the fleet-package attribute: + ▸ provide the argument rollout on the command line with a fully + specified name; + ▸ provide the argument --fleet-package on the command line. + + --location=LOCATION + Google Cloud zone or region for the rollout. + + To set the location attribute: + ▸ provide the argument rollout on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property config_delivery/location. + +FLAGS + --reason=REASON + Reason for aborting rollout. + +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/hub/packages/rollouts/describe b/gcloud/alpha/container/hub/packages/rollouts/describe new file mode 100644 index 000000000..330758281 --- /dev/null +++ b/gcloud/alpha/container/hub/packages/rollouts/describe @@ -0,0 +1,47 @@ +NAME + gcloud alpha container hub packages rollouts describe - describe Rollout + resource + +SYNOPSIS + gcloud alpha container hub packages rollouts describe NAME + --fleet-package=FLEET_PACKAGE [--less] [--location=LOCATION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe Rollout resource. + +EXAMPLES + To view Rollout 20240318 for cert-manager-app in us-central1, run: + + $ gcloud alpha container hub packages rollouts describe 20240318 \ + --fleet-package=cert-manager-app --location=us-central1 + +POSITIONAL ARGUMENTS + NAME + Resource name. + +REQUIRED FLAGS + --fleet-package=FLEET_PACKAGE + Parent Fleet Package of the Rollout. + +OPTIONAL FLAGS + --less + Show less verbose output. + + --location=LOCATION + Google Cloud zone or region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/container/hub/packages/rollouts/help b/gcloud/alpha/container/hub/packages/rollouts/help new file mode 100644 index 000000000..325570921 --- /dev/null +++ b/gcloud/alpha/container/hub/packages/rollouts/help @@ -0,0 +1,39 @@ +NAME + gcloud alpha container hub packages rollouts - commands for managing + Rollouts + +SYNOPSIS + gcloud alpha container hub packages rollouts COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) See gcloud alpha container fleet packages rollouts --help for help. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + abort + (ALPHA) Abort Rollout resource. + + describe + (ALPHA) Describe Rollout resource. + + list + (ALPHA) List Rollouts of a Fleet Package. + + resume + (ALPHA) Resume suspended Rollout. + + suspend + (ALPHA) Suspend in-progress Rollout. + +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/hub/packages/rollouts/list b/gcloud/alpha/container/hub/packages/rollouts/list new file mode 100644 index 000000000..587688785 --- /dev/null +++ b/gcloud/alpha/container/hub/packages/rollouts/list @@ -0,0 +1,77 @@ +NAME + gcloud alpha container hub packages rollouts list - list Rollouts of a + Fleet Package + +SYNOPSIS + gcloud alpha container hub packages rollouts list + --fleet-package=FLEET_PACKAGE [--less] [--location=LOCATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List Rollouts of a Fleet Package. + +EXAMPLES + To list all Rollouts for Fleet Package cert-manager-app in us-central1, + run: + + $ gcloud alpha container hub packages rollouts list \ + --fleet-package=cert-manager-app --location=us-central1 + +REQUIRED FLAGS + --fleet-package=FLEET_PACKAGE + Parent Fleet Package of the Rollout. + +FLAGS + --less + Show less verbose output. + + --location=LOCATION + Google Cloud zone or region. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/container/hub/packages/rollouts/resume b/gcloud/alpha/container/hub/packages/rollouts/resume new file mode 100644 index 000000000..6eec55d10 --- /dev/null +++ b/gcloud/alpha/container/hub/packages/rollouts/resume @@ -0,0 +1,74 @@ +NAME + gcloud alpha container hub packages rollouts resume - resume suspended + Rollout + +SYNOPSIS + gcloud alpha container hub packages rollouts resume + (ROLLOUT : --fleet-package=FLEET_PACKAGE --location=LOCATION) + [--reason=REASON] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Resume suspended Rollout. + +EXAMPLES + To resume Rollout 20240318 for cert-manager-app in us-central1, run: + + $ gcloud alpha container hub packages rollouts resume 20240318 \ + --fleet-package=cert-manager-app --location=us-central1 + +POSITIONAL ARGUMENTS + Rollout resource - The rollout to resume. 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 rollout on the command line with a fully + specified name; + ◆ set the property core/project. + + This must be specified. + + ROLLOUT + ID of the rollout or fully qualified identifier for the rollout. + + To set the rollout attribute: + ▸ provide the argument rollout on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --fleet-package=FLEET_PACKAGE + Fleet Package name. + + To set the fleet-package attribute: + ▸ provide the argument rollout on the command line with a fully + specified name; + ▸ provide the argument --fleet-package on the command line. + + --location=LOCATION + Google Cloud zone or region for the rollout. + + To set the location attribute: + ▸ provide the argument rollout on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property config_delivery/location. + +FLAGS + --reason=REASON + Reason for resuming rollout. + +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/hub/packages/rollouts/suspend b/gcloud/alpha/container/hub/packages/rollouts/suspend new file mode 100644 index 000000000..f5d57f70a --- /dev/null +++ b/gcloud/alpha/container/hub/packages/rollouts/suspend @@ -0,0 +1,74 @@ +NAME + gcloud alpha container hub packages rollouts suspend - suspend in-progress + Rollout + +SYNOPSIS + gcloud alpha container hub packages rollouts suspend + (ROLLOUT : --fleet-package=FLEET_PACKAGE --location=LOCATION) + [--reason=REASON] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Suspend in-progress Rollout. + +EXAMPLES + To suspend Rollout 20240318 for cert-manager-app in us-central1, run: + + $ gcloud alpha container hub packages rollouts suspend 20240318 \ + --fleet-package=cert-manager-app --location=us-central1 + +POSITIONAL ARGUMENTS + Rollout resource - The rollout to suspend. 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 rollout on the command line with a fully + specified name; + ◆ set the property core/project. + + This must be specified. + + ROLLOUT + ID of the rollout or fully qualified identifier for the rollout. + + To set the rollout attribute: + ▸ provide the argument rollout on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --fleet-package=FLEET_PACKAGE + Fleet Package name. + + To set the fleet-package attribute: + ▸ provide the argument rollout on the command line with a fully + specified name; + ▸ provide the argument --fleet-package on the command line. + + --location=LOCATION + Google Cloud zone or region for the rollout. + + To set the location attribute: + ▸ provide the argument rollout on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property config_delivery/location. + +FLAGS + --reason=REASON + Reason for suspending rollout. + +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/hub/packages/update b/gcloud/alpha/container/hub/packages/update new file mode 100644 index 000000000..d60ac575d --- /dev/null +++ b/gcloud/alpha/container/hub/packages/update @@ -0,0 +1,68 @@ +NAME + gcloud alpha container hub packages update - update Package Rollouts Fleet + Package + +SYNOPSIS + gcloud alpha container hub packages update + (FLEET_PACKAGE : --location=LOCATION) [--source=SOURCE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Update Package Rollouts Fleet Package. + +EXAMPLES + To update Fleet Package cert-manager-app, run: + + $ gcloud alpha container hub packages update cert-manager-app \ + --source=my_source.yaml + +POSITIONAL ARGUMENTS + Fleet package resource - The Fleet Package 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 fleet_package on the command line with a fully + specified name; + ◆ set the property core/project. + + This must be specified. + + FLEET_PACKAGE + ID of the fleet-package or fully qualified identifier for the + fleet-package. + + To set the fleet-package attribute: + ▸ provide the argument fleet_package on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud zone or region for the fleet-package. + + To set the location attribute: + ▸ provide the argument fleet_package on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property config_delivery/location. + +FLAGS + --source=SOURCE + Source file containing Fleet Package configuration. + +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/dataplex/entries/help b/gcloud/alpha/dataplex/entries/help index 609dbc60b..34fde88bf 100644 --- a/gcloud/alpha/dataplex/entries/help +++ b/gcloud/alpha/dataplex/entries/help @@ -33,6 +33,9 @@ COMMANDS remove-aspects (ALPHA) Remove aspects from a Dataplex Entry. + search + (ALPHA) Searches for Dataplex entries. + update (ALPHA) Update a Dataplex Entry. diff --git a/gcloud/alpha/dataplex/entries/search b/gcloud/alpha/dataplex/entries/search new file mode 100644 index 000000000..20df11aa9 --- /dev/null +++ b/gcloud/alpha/dataplex/entries/search @@ -0,0 +1,63 @@ +NAME + gcloud alpha dataplex entries search - searches for Dataplex entries + +SYNOPSIS + gcloud alpha dataplex entries search QUERY --project=PROJECT + [--limit=LIMIT] [--order-by=ORDER_BY] [--page-size=PAGE_SIZE] + [--scope=SCOPE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Searches for entries matching given query and scope. + +EXAMPLES + To search project 'my-project' for Dataplex resources that match the simple + predicate 'foo': + + $ gcloud alpha dataplex entries search 'foo' --project=my-project + +POSITIONAL ARGUMENTS + QUERY + The query against which entries in scope should be matched. + +REQUIRED FLAGS + --project=PROJECT + The project to which the request should be attributed. + +OPTIONAL FLAGS + --limit=LIMIT + Maximum number of resources. + + --order-by=ORDER_BY + Specifies the ordering of results, currently supported case-sensitive + choices are: + + ◆ title [asc|desc], defaults to ascending if not specified. + + --page-size=PAGE_SIZE + Maximum number of resources per page. No more than 1000. + + --scope=SCOPE + The scope under which the search should be operating. Should either be + organizations/ or projects/. If left unspecified, + it will default to the organization where the project is located. + +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 dataplex/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/dataplex/docs + +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 dataplex entries search + diff --git a/gcloud/alpha/domains/registrations/help b/gcloud/alpha/domains/registrations/help index 80d911d5b..77876678e 100644 --- a/gcloud/alpha/domains/registrations/help +++ b/gcloud/alpha/domains/registrations/help @@ -38,12 +38,18 @@ COMMANDS (ALPHA) Get register parameters (including availability) of a specific domain. + initiate-push-transfer + (ALPHA) Initiates the push transfer process. + list (ALPHA) List Cloud Domains registrations. register (ALPHA) Register a new domain. + renew-domain + (ALPHA) Renew a recently expired Cloud Domains registration. + search-domains (ALPHA) Search for available domains. diff --git a/gcloud/alpha/domains/registrations/initiate-push-transfer b/gcloud/alpha/domains/registrations/initiate-push-transfer new file mode 100644 index 000000000..8f3fb088e --- /dev/null +++ b/gcloud/alpha/domains/registrations/initiate-push-transfer @@ -0,0 +1,78 @@ +NAME + gcloud alpha domains registrations initiate-push-transfer - initiates the + push transfer process + +SYNOPSIS + gcloud alpha domains registrations initiate-push-transfer REGISTRATION + [--async] [--tag=TAG] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Initiates the Push Transfer process to transfer the domain to + another registrar. The process might complete instantly or might require + confirmation or additional work. Check the emails sent to the email address + of the registrant. The process is aborted after a timeout if it's not + completed. + + This method is only supported for domains that have the + REQUIRE_PUSH_TRANSFER property in the list of domain_properties. The domain + must also be unlocked before it can be transferred to a different + registrar. + +EXAMPLES + To initiate a push transfer for example.co.uk, run: + + $ gcloud alpha domains registrations initiate-push-transfer \ + example.co.uk --tag=NEW_REGISTRY_TAG + +POSITIONAL ARGUMENTS + Registration resource - The domain registration to transfer. 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 registration on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument registration on the command line with a fully + specified name; + ◆ location is always global. + + This must be specified. + + REGISTRATION + ID of the registration or fully qualified identifier for the + registration. + + To set the registration attribute: + ▸ provide the argument registration on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --tag=TAG + The Tag of the new registrar. Can be found at + https://nominet.uk/registrar-list/ + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +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 domains registrations initiate-push-transfer + + $ gcloud beta domains registrations initiate-push-transfer + diff --git a/gcloud/alpha/domains/registrations/register b/gcloud/alpha/domains/registrations/register index 86ba7708c..87b1dce07 100644 --- a/gcloud/alpha/domains/registrations/register +++ b/gcloud/alpha/domains/registrations/register @@ -210,10 +210,9 @@ OTHER FLAGS https://support.google.com/domains/answer/7638036 for details. --yearly-price=YEARLY_PRICE - You must accept the yearly price of the domain, either in the - interactive flow or using this flag. The expected format is a number - followed by a currency code, e.g. "12.00 USD". You can get the price - using the get-register-parameters command. + Accept the domain's yearly price in the interactive flow or by using + this flag. Use a number followed by a currency code, for example, + "12.00 USD". Get the price using the get-register-parameters command. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/domains/registrations/renew-domain b/gcloud/alpha/domains/registrations/renew-domain new file mode 100644 index 000000000..0c1616ef2 --- /dev/null +++ b/gcloud/alpha/domains/registrations/renew-domain @@ -0,0 +1,83 @@ +NAME + gcloud alpha domains registrations renew-domain - renew a recently expired + Cloud Domains registration + +SYNOPSIS + gcloud alpha domains registrations renew-domain REGISTRATION + [--validate-only] [--async] [--yearly-price=YEARLY_PRICE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Use this method to renew domains that expired within the last 30 + days. Renewing your domain extends it for one year from the previous + expiration date and you are charged the yearly renewal price. + +EXAMPLES + To renew a registration for example.com interactively, run: + + $ gcloud alpha domains registrations renew-domain example.com + + To renew example.com with interactive prompts disabled, provide the + --yearly-price flag. For example, run: + + $ gcloud alpha domains registrations renew-domain example.com \ + --yearly-price="12.00 USD" --quiet + +POSITIONAL ARGUMENTS + Registration resource - The domain registration to renew. 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 registration on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument registration on the command line with a fully + specified name; + ◆ location is always global. + + This must be specified. + + REGISTRATION + ID of the registration or fully qualified identifier for the + registration. + + To set the registration attribute: + ▸ provide the argument registration on the command line. + +COMMONLY USED FLAGS + --validate-only + Don't actually renew registration. Only validate arguments. + +OTHER FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --yearly-price=YEARLY_PRICE + Accept the domain's yearly price in the interactive flow or by using + this flag. Use a number followed by a currency code, for example, + "12.00 USD". Get the price by calling the renew-domain command without + the --yearly-price flag. + +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. These variants are also available: + + $ gcloud domains registrations renew-domain + + $ gcloud beta domains registrations renew-domain + diff --git a/gcloud/alpha/functions/deploy b/gcloud/alpha/functions/deploy index d1ca5efc5..7a5e285e1 100644 --- a/gcloud/alpha/functions/deploy +++ b/gcloud/alpha/functions/deploy @@ -184,9 +184,9 @@ FLAGS For a list of available runtimes, run gcloud functions runtimes list. --runtime-update-policy=RUNTIME_UPDATE_POLICY - Runtime update policy for the 1st gen function being deployed. The - option on-deploy is used by default. RUNTIME_UPDATE_POLICY must be one - of: automatic, on-deploy. + Runtime update policy for the function being deployed. The option + automatic is used by default. RUNTIME_UPDATE_POLICY must be one of: + automatic, on-deploy. --security-level=SECURITY_LEVEL; default="secure-always" Security level controls whether a function's URL supports HTTPS only or diff --git a/gcloud/alpha/healthcare/fhir-stores/create b/gcloud/alpha/healthcare/fhir-stores/create index 74b73ade9..aac34e015 100644 --- a/gcloud/alpha/healthcare/fhir-stores/create +++ b/gcloud/alpha/healthcare/fhir-stores/create @@ -6,8 +6,9 @@ SYNOPSIS gcloud alpha healthcare fhir-stores create (FHIR_STORE : --dataset=DATASET --location=LOCATION) [--disable-referential-integrity] [--disable-resource-versioning] - [--enable-update-create] [--pubsub-topic=PUBSUB_TOPIC] - [--version=VERSION] [GCLOUD_WIDE_FLAG ...] + [--enable-history-modifications] [--enable-update-create] + [--pubsub-topic=PUBSUB_TOPIC] [--version=VERSION] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Creates a Cloud Healthcare API FHIR store. @@ -81,6 +82,15 @@ FLAGS can be fetched through the history APIs, but cannot be updated. This field is immutable after store creation. + --enable-history-modifications + Whether this FHIR store has history modifications enabled. Enabling + history modifications is required to use FHIR history bundles with the + executeBundle + (https://cloud.google.com/healthcare-api/docs/reference/rest/v1beta1/projects.locations.datasets.fhirStores.fhir/executeBundle) + and importHistory + (https://cloud.google.com/healthcare-api/docs/reference/rest/v1beta1/projects.locations.datasets.fhirStores/importHistory) + APIs. + --enable-update-create Whether this FHIR store has the [updateCreate] (https://www.hl7.org/fhir/capabilitystatement-definitions.html#CapabilityStatement.rest.resource.updateCreate) diff --git a/gcloud/alpha/healthcare/fhir-stores/update b/gcloud/alpha/healthcare/fhir-stores/update index 9fba5612a..e90c44cfe 100644 --- a/gcloud/alpha/healthcare/fhir-stores/update +++ b/gcloud/alpha/healthcare/fhir-stores/update @@ -5,8 +5,8 @@ NAME SYNOPSIS gcloud alpha healthcare fhir-stores update (FHIR_STORE : --dataset=DATASET --location=LOCATION) - [--enable-update-create] [--pubsub-topic=PUBSUB_TOPIC] - [GCLOUD_WIDE_FLAG ...] + [--enable-history-modifications] [--enable-update-create] + [--pubsub-topic=PUBSUB_TOPIC] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Update a Cloud Healthcare API FHIR store. @@ -58,6 +58,15 @@ POSITIONAL ARGUMENTS ▸ set the property healthcare/location. FLAGS + --enable-history-modifications + Whether this FHIR store has history modifications enabled. Enabling + history modifications is required to use FHIR history bundles with the + executeBundle + (https://cloud.google.com/healthcare-api/docs/reference/rest/v1beta1/projects.locations.datasets.fhirStores.fhir/executeBundle) + and importHistory + (https://cloud.google.com/healthcare-api/docs/reference/rest/v1beta1/projects.locations.datasets.fhirStores/importHistory) + APIs. + --enable-update-create Whether this FHIR store has the [updateCreate] (https://www.hl7.org/fhir/capabilitystatement-definitions.html#CapabilityStatement.rest.resource.updateCreate) diff --git a/gcloud/alpha/network-services/help b/gcloud/alpha/network-services/help index cdee2cf66..21f697c98 100644 --- a/gcloud/alpha/network-services/help +++ b/gcloud/alpha/network-services/help @@ -33,12 +33,30 @@ GROUPS meshes (ALPHA) Manage Network Services Meshes. + multicast-consumer-associations + (ALPHA) Manage Network Services MulticastConsumerAssociations. + + multicast-domain-activations + (ALPHA) Manage Network Services MulticastDomainActivations. + multicast-domains (ALPHA) Manage Network Services MulticastDomains. + multicast-group-consumer-activations + (ALPHA) Manage Network Services MulticastGroupConsumerActivations. + + multicast-group-definitions + (ALPHA) Manage Network Services MulticastGroupDefinitions. + + multicast-groups + (ALPHA) Manage Network Services MulticastGroups. + observability-policies (ALPHA) Manage Network Services ObservabilityPolicies. + route-views + (ALPHA) View Network Services Route Views. + service-bindings (ALPHA) Manage Network Services Bindings. diff --git a/gcloud/alpha/network-services/multicast-consumer-associations/create b/gcloud/alpha/network-services/multicast-consumer-associations/create new file mode 100644 index 000000000..2379919b0 --- /dev/null +++ b/gcloud/alpha/network-services/multicast-consumer-associations/create @@ -0,0 +1,99 @@ +NAME + gcloud alpha network-services multicast-consumer-associations create - + create a multicast consumer association + +SYNOPSIS + gcloud alpha network-services multicast-consumer-associations create + (MULTICAST_CONSUMER_ASSOCIATION : --location=LOCATION) + --multicast-domain-activation=MULTICAST_DOMAIN_ACTIVATION + --network=NETWORK [--async] [--description=DESCRIPTION] + [--labels=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create a multicast consumer association in the specified location + of the current project. + +EXAMPLES + Create a multicast consumer association with the name + 'my-multicast-consumer-association', multicast-domain-activation + 'path-to-mda', network 'path-to-network', and location 'zone'. + + $ gcloud alpha network-services multicast-consumer-associations \ + create my-multicast-consumer-association \ + --multicast-domain-activation=path-to-mda \ + --network=path-to-network --location=zone + +POSITIONAL ARGUMENTS + Multicast consumer association resource - Name of the multicast group to + be created. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_consumer_association 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. + + MULTICAST_CONSUMER_ASSOCIATION + ID of the multicast consumer association or fully qualified + identifier for the multicast consumer association. + + To set the multicast_consumer_association attribute: + ▸ provide the argument multicast_consumer_association on the + command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_consumer_association on the + command line with a fully specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --multicast-domain-activation=MULTICAST_DOMAIN_ACTIVATION + The multicast domain activation to be used. + + --network=NETWORK + The path of the multicast consumer VPC network. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + The description for the multicast consumer association. + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/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. + diff --git a/gcloud/alpha/network-services/multicast-consumer-associations/delete b/gcloud/alpha/network-services/multicast-consumer-associations/delete new file mode 100644 index 000000000..488a03477 --- /dev/null +++ b/gcloud/alpha/network-services/multicast-consumer-associations/delete @@ -0,0 +1,70 @@ +NAME + gcloud alpha network-services multicast-consumer-associations delete - + delete a multicast consumer association + +SYNOPSIS + gcloud alpha network-services multicast-consumer-associations delete + (MULTICAST_CONSUMER_ASSOCIATION : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete a multicast consumer association in the specified location + of the current project. + +EXAMPLES + To delete a multicast consumer association in the current project, run: + + $ gcloud alpha network-services multicast-consumer-associations \ + delete my-multicast-consumer-association --location=zone + +POSITIONAL ARGUMENTS + Multicast consumer association resource - The multicast consumer + association to delete. The arguments in this group can be used to specify + the attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_consumer_association on the command + line with a fully specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + MULTICAST_CONSUMER_ASSOCIATION + ID of the multicast consumer association or fully qualified + identifier for the multicast consumer association. + + To set the multicast_consumer_association attribute: + ▸ provide the argument multicast_consumer_association on the + command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_consumer_association on the + command line with a fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/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. + diff --git a/gcloud/alpha/network-services/multicast-consumer-associations/describe b/gcloud/alpha/network-services/multicast-consumer-associations/describe new file mode 100644 index 000000000..6690e87b2 --- /dev/null +++ b/gcloud/alpha/network-services/multicast-consumer-associations/describe @@ -0,0 +1,71 @@ +NAME + gcloud alpha network-services multicast-consumer-associations describe - + describe a multicast consumer associations + +SYNOPSIS + gcloud alpha network-services multicast-consumer-associations describe + (MULTICAST_CONSUMER_ASSOCIATION : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Show details of a multicast consumer association in the specified + location of the current project. + +EXAMPLES + To describe details of a multicast consumer association in the current + project and location, run: + + $ gcloud alpha network-services multicast-consumer-associations \ + describe my-multicast-consumer-association --location=zone + +POSITIONAL ARGUMENTS + Multicast consumer association resource - The multicast consumer + association to display. The arguments in this group can be used to specify + the attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_consumer_association on the command + line with a fully specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + MULTICAST_CONSUMER_ASSOCIATION + ID of the multicast consumer association or fully qualified + identifier for the multicast consumer association. + + To set the multicast_consumer_association attribute: + ▸ provide the argument multicast_consumer_association on the + command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_consumer_association on the + command line with a fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/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. + diff --git a/gcloud/alpha/network-services/multicast-consumer-associations/help b/gcloud/alpha/network-services/multicast-consumer-associations/help new file mode 100644 index 000000000..b8af6056c --- /dev/null +++ b/gcloud/alpha/network-services/multicast-consumer-associations/help @@ -0,0 +1,37 @@ +NAME + gcloud alpha network-services multicast-consumer-associations - manage + Network Services MulticastConsumerAssociations + +SYNOPSIS + gcloud alpha network-services multicast-consumer-associations COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Network Services MulticastConsumerAssociations. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Create a multicast consumer association. + + delete + (ALPHA) Delete a multicast consumer association. + + describe + (ALPHA) Describe a multicast consumer associations. + + list + (ALPHA) List multicast consumer associations. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/network-services/multicast-consumer-associations/list b/gcloud/alpha/network-services/multicast-consumer-associations/list new file mode 100644 index 000000000..fb136f017 --- /dev/null +++ b/gcloud/alpha/network-services/multicast-consumer-associations/list @@ -0,0 +1,89 @@ +NAME + gcloud alpha network-services multicast-consumer-associations list - list + multicast consumer associations + +SYNOPSIS + gcloud alpha network-services multicast-consumer-associations list + --location=LOCATION [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List all multicast consumer associations in the specified location + of the current project. + +EXAMPLES + To list multicast groups in the current project and location, run: + + $ gcloud alpha network-services multicast-consumer-associations \ + list --location=zone + +REQUIRED FLAGS + Location resource - The location of the multicast consumer associations to + display. This represents a Cloud resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ 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 networkservices/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. + diff --git a/gcloud/alpha/network-services/multicast-domain-activations/create b/gcloud/alpha/network-services/multicast-domain-activations/create new file mode 100644 index 000000000..00e45a62f --- /dev/null +++ b/gcloud/alpha/network-services/multicast-domain-activations/create @@ -0,0 +1,95 @@ +NAME + gcloud alpha network-services multicast-domain-activations create - create + a multicast domain activation + +SYNOPSIS + gcloud alpha network-services multicast-domain-activations create + (MULTICAST_DOMAIN_ACTIVATION : --location=LOCATION) + --multicast-domain=MULTICAST_DOMAIN [--async] + [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create a multicast domain activation in the specified location of + the current project. + +EXAMPLES + Create a multicast domain activation with the name + 'my-multicast-domain-activation', multicast-domain 'path-to-md', and + location 'zone'. + + $ gcloud alpha network-services multicast-domain-activations \ + create my-multicast-group-definition \ + --multicast-domain=path-to-md --location=zone + +POSITIONAL ARGUMENTS + Multicast domain activation resource - Name of the multicast group + definition to be created. The arguments in this group can be used to + specify the attributes of this resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_domain_activation on the command line + with a fully specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + MULTICAST_DOMAIN_ACTIVATION + ID of the multicast domain activation or fully qualified identifier + for the multicast domain activation. + + To set the multicast_domain_activation attribute: + ▸ provide the argument multicast_domain_activation on the command + line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_domain_activation on the command + line with a fully specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --multicast-domain=MULTICAST_DOMAIN + The multicast domain to be used. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + The description for the multicast domain activation. + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/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. + diff --git a/gcloud/alpha/network-services/multicast-domain-activations/delete b/gcloud/alpha/network-services/multicast-domain-activations/delete new file mode 100644 index 000000000..d4742a053 --- /dev/null +++ b/gcloud/alpha/network-services/multicast-domain-activations/delete @@ -0,0 +1,70 @@ +NAME + gcloud alpha network-services multicast-domain-activations delete - delete + a multicast domain activation + +SYNOPSIS + gcloud alpha network-services multicast-domain-activations delete + (MULTICAST_DOMAIN_ACTIVATION : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete a multicast domain activation in the specified location of + the current project. + +EXAMPLES + To delete a multicast domain activation in the current project, run: + + $ gcloud alpha network-services multicast-domain-activations \ + delete my-multicast-domain-activation --location=zone + +POSITIONAL ARGUMENTS + Multicast domain activation resource - The multicast domain activation to + delete. The arguments in this group can be used to specify the attributes + of this resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_domain_activation on the command line + with a fully specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + MULTICAST_DOMAIN_ACTIVATION + ID of the multicast domain activation or fully qualified identifier + for the multicast domain activation. + + To set the multicast_domain_activation attribute: + ▸ provide the argument multicast_domain_activation on the command + line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_domain_activation on the command + line with a fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/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. + diff --git a/gcloud/alpha/network-services/multicast-domain-activations/describe b/gcloud/alpha/network-services/multicast-domain-activations/describe new file mode 100644 index 000000000..6e3eff371 --- /dev/null +++ b/gcloud/alpha/network-services/multicast-domain-activations/describe @@ -0,0 +1,71 @@ +NAME + gcloud alpha network-services multicast-domain-activations describe - + describe a multicast domain activation + +SYNOPSIS + gcloud alpha network-services multicast-domain-activations describe + (MULTICAST_DOMAIN_ACTIVATION : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Show details of a multicast domain activation in the specified + location of the current project. + +EXAMPLES + To describe details of a multicast domain activation in the current project + and location, run: + + $ gcloud alpha network-services multicast-domain-activations \ + describe my-multicast-domain-activation --location=zone + +POSITIONAL ARGUMENTS + Multicast domain activation resource - The multicast domain activation to + display. The arguments in this group can be used to specify the attributes + of this resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_domain_activation on the command line + with a fully specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + MULTICAST_DOMAIN_ACTIVATION + ID of the multicast domain activation or fully qualified identifier + for the multicast domain activation. + + To set the multicast_domain_activation attribute: + ▸ provide the argument multicast_domain_activation on the command + line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_domain_activation on the command + line with a fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/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. + diff --git a/gcloud/alpha/network-services/multicast-domain-activations/help b/gcloud/alpha/network-services/multicast-domain-activations/help new file mode 100644 index 000000000..f9036d1a4 --- /dev/null +++ b/gcloud/alpha/network-services/multicast-domain-activations/help @@ -0,0 +1,37 @@ +NAME + gcloud alpha network-services multicast-domain-activations - manage Network + Services MulticastDomainActivations + +SYNOPSIS + gcloud alpha network-services multicast-domain-activations COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Network Services MulticastDomainActivations. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Create a multicast domain activation. + + delete + (ALPHA) Delete a multicast domain activation. + + describe + (ALPHA) Describe a multicast domain activation. + + list + (ALPHA) List multicast domain activations. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/network-services/multicast-domain-activations/list b/gcloud/alpha/network-services/multicast-domain-activations/list new file mode 100644 index 000000000..21bc5bd86 --- /dev/null +++ b/gcloud/alpha/network-services/multicast-domain-activations/list @@ -0,0 +1,90 @@ +NAME + gcloud alpha network-services multicast-domain-activations list - list + multicast domain activations + +SYNOPSIS + gcloud alpha network-services multicast-domain-activations list + --location=LOCATION [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List all multicast domain activations in the specified location of + the current project. + +EXAMPLES + To list multicast domain activations in the current project and location, + run: + + $ gcloud alpha network-services multicast-domain-activations list \ + --location=zone + +REQUIRED FLAGS + Location resource - The location of the multicast domains to display. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ 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 networkservices/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. + diff --git a/gcloud/alpha/network-services/multicast-group-consumer-activations/create b/gcloud/alpha/network-services/multicast-group-consumer-activations/create new file mode 100644 index 000000000..e7f9c8a88 --- /dev/null +++ b/gcloud/alpha/network-services/multicast-group-consumer-activations/create @@ -0,0 +1,100 @@ +NAME + gcloud alpha network-services multicast-group-consumer-activations create - + create a multicast group consumer activation + +SYNOPSIS + gcloud alpha network-services multicast-group-consumer-activations create + (MULTICAST_GROUP_CONSUMER_ACTIVATION : --location=LOCATION) + --multicast-consumer-association=MULTICAST_CONSUMER_ASSOCIATION + --multicast-group=MULTICAST_GROUP [--async] [--description=DESCRIPTION] + [--labels=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create a multicast group consumer activation in the specified + location of the current project. + +EXAMPLES + Create a multicast group consumer activation with the name + 'my-multicast-group-consumer-activation', multicast-consumer-association + 'path-to-mca', multicast-group 'path-to-mg', and location 'zone'. + + $ gcloud alpha network-services \ + multicast-group-consumer-activations create \ + my-multicast-group-consumer-activation \ + --multicast-consumer-association=path-to-mca \ + --multicast-group=path-to-mg --location=zone + +POSITIONAL ARGUMENTS + Multicast group consumer activation resource - Name of the multicast group + consumer activation to be created. The arguments in this group can be used + to specify the attributes of this resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_group_consumer_activation on the + command line with a fully specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + MULTICAST_GROUP_CONSUMER_ACTIVATION + ID of the multicast group consumer activation or fully qualified + identifier for the multicast group consumer activation. + + To set the multicast_group_consumer_activation attribute: + ▸ provide the argument multicast_group_consumer_activation on the + command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_group_consumer_activation on the + command line with a fully specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --multicast-consumer-association=MULTICAST_CONSUMER_ASSOCIATION + The multicast consumer association to be used. + + --multicast-group=MULTICAST_GROUP + The multicast group to be used. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + The description for the multicast group consumer activation. + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/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. + diff --git a/gcloud/alpha/network-services/multicast-group-consumer-activations/delete b/gcloud/alpha/network-services/multicast-group-consumer-activations/delete new file mode 100644 index 000000000..6daf638ee --- /dev/null +++ b/gcloud/alpha/network-services/multicast-group-consumer-activations/delete @@ -0,0 +1,72 @@ +NAME + gcloud alpha network-services multicast-group-consumer-activations delete - + delete a multicast group consumer activation + +SYNOPSIS + gcloud alpha network-services multicast-group-consumer-activations delete + (MULTICAST_GROUP_CONSUMER_ACTIVATION : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete a multicast group consumer activation in the specified + location of the current project. + +EXAMPLES + To delete a multicast group consumer activation in the current project, + run: + + $ gcloud alpha network-services \ + multicast-group-consumer-activations delete \ + my-multicast-group-consumer-activation --location=zone + +POSITIONAL ARGUMENTS + Multicast group consumer activation resource - The multicast group + consumer activation to delete. The arguments in this group can be used to + specify the attributes of this resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_group_consumer_activation on the + command line with a fully specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + MULTICAST_GROUP_CONSUMER_ACTIVATION + ID of the multicast group consumer activation or fully qualified + identifier for the multicast group consumer activation. + + To set the multicast_group_consumer_activation attribute: + ▸ provide the argument multicast_group_consumer_activation on the + command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_group_consumer_activation on the + command line with a fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/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. + diff --git a/gcloud/alpha/network-services/multicast-group-consumer-activations/describe b/gcloud/alpha/network-services/multicast-group-consumer-activations/describe new file mode 100644 index 000000000..edebdbece --- /dev/null +++ b/gcloud/alpha/network-services/multicast-group-consumer-activations/describe @@ -0,0 +1,72 @@ +NAME + gcloud alpha network-services multicast-group-consumer-activations describe + - describe a multicast group consumer activations + +SYNOPSIS + gcloud alpha network-services multicast-group-consumer-activations describe + (MULTICAST_GROUP_CONSUMER_ACTIVATION : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Show details of a multicastgroup consumer activations in the + specified location of the current project. + +EXAMPLES + To describe details of a multicast group consumer activations in the + current project and location, run: + + $ gcloud alpha network-services \ + multicast-group-consumer-activations describe \ + my-multicast-group-consumer-activation --location=zone + +POSITIONAL ARGUMENTS + Multicast group consumer activation resource - The multicast group + consumer activation to display. The arguments in this group can be used to + specify the attributes of this resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_group_consumer_activation on the + command line with a fully specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + MULTICAST_GROUP_CONSUMER_ACTIVATION + ID of the multicast group consumer activation or fully qualified + identifier for the multicast group consumer activation. + + To set the multicast_group_consumer_activation attribute: + ▸ provide the argument multicast_group_consumer_activation on the + command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_group_consumer_activation on the + command line with a fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/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. + diff --git a/gcloud/alpha/network-services/multicast-group-consumer-activations/help b/gcloud/alpha/network-services/multicast-group-consumer-activations/help new file mode 100644 index 000000000..4fa39af77 --- /dev/null +++ b/gcloud/alpha/network-services/multicast-group-consumer-activations/help @@ -0,0 +1,37 @@ +NAME + gcloud alpha network-services multicast-group-consumer-activations - manage + Network Services MulticastGroupConsumerActivations + +SYNOPSIS + gcloud alpha network-services multicast-group-consumer-activations COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Network Services MulticastGroupConsumerActivations. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Create a multicast group consumer activation. + + delete + (ALPHA) Delete a multicast group consumer activation. + + describe + (ALPHA) Describe a multicast group consumer activations. + + list + (ALPHA) List multicast group consumer activations. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/network-services/multicast-group-consumer-activations/list b/gcloud/alpha/network-services/multicast-group-consumer-activations/list new file mode 100644 index 000000000..54ef0c3b4 --- /dev/null +++ b/gcloud/alpha/network-services/multicast-group-consumer-activations/list @@ -0,0 +1,90 @@ +NAME + gcloud alpha network-services multicast-group-consumer-activations list - + list multicast group consumer activations + +SYNOPSIS + gcloud alpha network-services multicast-group-consumer-activations list + --location=LOCATION [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List all multicast group consumer activations in the specified + location of the current project. + +EXAMPLES + To list multicast group consumer activations in the current project and + location, run: + + $ gcloud alpha network-services \ + multicast-group-consumer-activations list --location=zone + +REQUIRED FLAGS + Location resource - The location of the multicast consumer associations to + display. This represents a Cloud resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ 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 networkservices/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. + diff --git a/gcloud/alpha/network-services/multicast-group-definitions/create b/gcloud/alpha/network-services/multicast-group-definitions/create new file mode 100644 index 000000000..430d69b76 --- /dev/null +++ b/gcloud/alpha/network-services/multicast-group-definitions/create @@ -0,0 +1,100 @@ +NAME + gcloud alpha network-services multicast-group-definitions create - create a + multicast group definition + +SYNOPSIS + gcloud alpha network-services multicast-group-definitions create + (MULTICAST_GROUP_DEFINITION : --location=LOCATION) + --multicast-domain=MULTICAST_DOMAIN + --reserved-internal-range=RESERVED_INTERNAL_RANGE [--async] + [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create a multicast group definition in the specified location of + the current project. + +EXAMPLES + Create a multicast group definition with the name + 'my-multicast-group-definition', reserved-internal-range 'path-to-ir', + multicast-domain 'path-to-md', and location 'global'. + + $ gcloud alpha network-services multicast-group-definitions create \ + my-multicast-group-definition \ + --reserved-internal-range=path-to-ir \ + --multicast-domain=path-to-md --location=global + +POSITIONAL ARGUMENTS + Multicast group definition resource - Name of the multicast group + definition to be created. The arguments in this group can be used to + specify the attributes of this resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_group_definition 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. + + MULTICAST_GROUP_DEFINITION + ID of the multicast group definition or fully qualified identifier + for the multicast group definition. + + To set the multicast_group_definition attribute: + ▸ provide the argument multicast_group_definition on the command + line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_group_definition on the command + line with a fully specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --multicast-domain=MULTICAST_DOMAIN + The multicast domain to be used. + + --reserved-internal-range=RESERVED_INTERNAL_RANGE + The reserved internal range to be used. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + The description for the multicast group definition. + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/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. + diff --git a/gcloud/alpha/network-services/multicast-group-definitions/delete b/gcloud/alpha/network-services/multicast-group-definitions/delete new file mode 100644 index 000000000..7445e274a --- /dev/null +++ b/gcloud/alpha/network-services/multicast-group-definitions/delete @@ -0,0 +1,70 @@ +NAME + gcloud alpha network-services multicast-group-definitions delete - delete a + multicast group definition + +SYNOPSIS + gcloud alpha network-services multicast-group-definitions delete + (MULTICAST_GROUP_DEFINITION : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete a multicast group definition in the specified location of + the current project. + +EXAMPLES + To delete a multicast group definition in the current project, run: + + $ gcloud alpha network-services multicast-group-definitions delete \ + my-multicast-group-definition --location=global + +POSITIONAL ARGUMENTS + Multicast group definition resource - The multicast group definition to + delete. The arguments in this group can be used to specify the attributes + of this resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_group_definition 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. + + MULTICAST_GROUP_DEFINITION + ID of the multicast group definition or fully qualified identifier + for the multicast group definition. + + To set the multicast_group_definition attribute: + ▸ provide the argument multicast_group_definition on the command + line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_group_definition on the command + line with a fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/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. + diff --git a/gcloud/alpha/network-services/multicast-group-definitions/describe b/gcloud/alpha/network-services/multicast-group-definitions/describe new file mode 100644 index 000000000..e3eeb4917 --- /dev/null +++ b/gcloud/alpha/network-services/multicast-group-definitions/describe @@ -0,0 +1,70 @@ +NAME + gcloud alpha network-services multicast-group-definitions describe - + describe a multicast group definition + +SYNOPSIS + gcloud alpha network-services multicast-group-definitions describe + (MULTICAST_GROUP_DEFINITION : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Show details of a multicast group definition in the specified + location of the current project. + +EXAMPLES + To describe a multicast group definition in the current project, run: + + $ gcloud alpha network-services multicast-group-definitions \ + describe my-multicast-group-definition --location=global + +POSITIONAL ARGUMENTS + Multicast group definition resource - The multicast group definition to + display. The arguments in this group can be used to specify the attributes + of this resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_group_definition 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. + + MULTICAST_GROUP_DEFINITION + ID of the multicast group definition or fully qualified identifier + for the multicast group definition. + + To set the multicast_group_definition attribute: + ▸ provide the argument multicast_group_definition on the command + line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_group_definition on the command + line with a fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/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. + diff --git a/gcloud/alpha/network-services/multicast-group-definitions/help b/gcloud/alpha/network-services/multicast-group-definitions/help new file mode 100644 index 000000000..ebf8c4f1f --- /dev/null +++ b/gcloud/alpha/network-services/multicast-group-definitions/help @@ -0,0 +1,37 @@ +NAME + gcloud alpha network-services multicast-group-definitions - manage Network + Services MulticastGroupDefinitions + +SYNOPSIS + gcloud alpha network-services multicast-group-definitions COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Network Services MulticastGroupDefinitions. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Create a multicast group definition. + + delete + (ALPHA) Delete a multicast group definition. + + describe + (ALPHA) Describe a multicast group definition. + + list + (ALPHA) List multicast group definitions. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/network-services/multicast-group-definitions/list b/gcloud/alpha/network-services/multicast-group-definitions/list new file mode 100644 index 000000000..1025f8c4d --- /dev/null +++ b/gcloud/alpha/network-services/multicast-group-definitions/list @@ -0,0 +1,89 @@ +NAME + gcloud alpha network-services multicast-group-definitions list - list + multicast group definitions + +SYNOPSIS + gcloud alpha network-services multicast-group-definitions list + --location=LOCATION [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List all multicast group definitions in the specified location of + the current project. + +EXAMPLES + To list multicast group definitions in the current project, run: + + $ gcloud alpha network-services multicast-group-definitions list \ + --location=global + +REQUIRED FLAGS + Location resource - The location of the multicast domains to display. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ 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 networkservices/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. + diff --git a/gcloud/alpha/network-services/multicast-groups/create b/gcloud/alpha/network-services/multicast-groups/create new file mode 100644 index 000000000..405a88664 --- /dev/null +++ b/gcloud/alpha/network-services/multicast-groups/create @@ -0,0 +1,98 @@ +NAME + gcloud alpha network-services multicast-groups create - create a multicast + group + +SYNOPSIS + gcloud alpha network-services multicast-groups create + (MULTICAST_GROUP : --location=LOCATION) + --multicast-domain-activation=MULTICAST_DOMAIN_ACTIVATION + --multicast-group-definition=MULTICAST_GROUP_DEFINITION [--async] + [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create a multicast group in the specified location of the current + project. + +EXAMPLES + Create a multicast group with the name 'my-multicast-group', + multicast-group-definition 'path-to-mgd', multicast-domain-activation + 'path-to-mda', and location 'zone'. + + $ gcloud alpha network-services multicast-groups create \ + my-multicast-group --multicast-group-definition=path-to-mgd \ + --multicast-domain-activation=path-to-mda --location=zone + +POSITIONAL ARGUMENTS + Multicast group resource - Name of the multicast group to be created. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_group 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. + + MULTICAST_GROUP + ID of the multicast group or fully qualified identifier for the + multicast group. + + To set the multicast_group attribute: + ▸ provide the argument multicast_group on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_group on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --multicast-domain-activation=MULTICAST_DOMAIN_ACTIVATION + The multicast domain activation to be used. + + --multicast-group-definition=MULTICAST_GROUP_DEFINITION + The multicast group definition to be used. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + The description for the multicast group. + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/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. + diff --git a/gcloud/alpha/network-services/multicast-groups/delete b/gcloud/alpha/network-services/multicast-groups/delete new file mode 100644 index 000000000..c022cbcf0 --- /dev/null +++ b/gcloud/alpha/network-services/multicast-groups/delete @@ -0,0 +1,68 @@ +NAME + gcloud alpha network-services multicast-groups delete - delete a multicast + group + +SYNOPSIS + gcloud alpha network-services multicast-groups delete + (MULTICAST_GROUP : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete a multicast group in the specified location of the current + project. + +EXAMPLES + To delete a multicast group in the current project, run: + + $ gcloud alpha network-services multicast-groups delete \ + my-multicast-group --location=zone + +POSITIONAL ARGUMENTS + Multicast group resource - The multicast group to delete. The arguments in + this group can be used to specify the attributes of this resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. + + To set the project attribute: + ◆ provide the argument multicast_group 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. + + MULTICAST_GROUP + ID of the multicast group or fully qualified identifier for the + multicast group. + + To set the multicast_group attribute: + ▸ provide the argument multicast_group on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_group on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/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. + diff --git a/gcloud/alpha/network-services/multicast-groups/describe b/gcloud/alpha/network-services/multicast-groups/describe new file mode 100644 index 000000000..cc83aa14d --- /dev/null +++ b/gcloud/alpha/network-services/multicast-groups/describe @@ -0,0 +1,69 @@ +NAME + gcloud alpha network-services multicast-groups describe - describe a + multicast groups + +SYNOPSIS + gcloud alpha network-services multicast-groups describe + (MULTICAST_GROUP : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Show details of a multicast group in the specified location of the + current project. + +EXAMPLES + To describe details of a multicast group in the current project and + location, run: + + $ gcloud alpha network-services multicast-groups describe \ + my-multicast-group --location=zone + +POSITIONAL ARGUMENTS + Multicast group resource - The multicast group to display. The arguments + in this group can be used to specify the attributes of this resource. + (NOTE) Some attributes are not given arguments in this group but can be + set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_group 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. + + MULTICAST_GROUP + ID of the multicast group or fully qualified identifier for the + multicast group. + + To set the multicast_group attribute: + ▸ provide the argument multicast_group on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_group on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/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. + diff --git a/gcloud/alpha/network-services/multicast-groups/help b/gcloud/alpha/network-services/multicast-groups/help new file mode 100644 index 000000000..7995c369b --- /dev/null +++ b/gcloud/alpha/network-services/multicast-groups/help @@ -0,0 +1,37 @@ +NAME + gcloud alpha network-services multicast-groups - manage Network Services + MulticastGroups + +SYNOPSIS + gcloud alpha network-services multicast-groups COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Network Services MulticastGroups. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Create a multicast group. + + delete + (ALPHA) Delete a multicast group. + + describe + (ALPHA) Describe a multicast groups. + + list + (ALPHA) List multicast groups. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/network-services/multicast-groups/list b/gcloud/alpha/network-services/multicast-groups/list new file mode 100644 index 000000000..8da4d3530 --- /dev/null +++ b/gcloud/alpha/network-services/multicast-groups/list @@ -0,0 +1,86 @@ +NAME + gcloud alpha network-services multicast-groups list - list multicast groups + +SYNOPSIS + gcloud alpha network-services multicast-groups list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List all multicast groups in the specified location of the current + project. + +EXAMPLES + To list multicast groups in the current project and location, run: + + $ gcloud alpha network-services multicast-groups list --location=zone + +REQUIRED FLAGS + Location resource - The location of the multicast groups to display. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ 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 networkservices/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. + diff --git a/gcloud/alpha/network-services/route-views/describe b/gcloud/alpha/network-services/route-views/describe new file mode 100644 index 000000000..f9a21c205 --- /dev/null +++ b/gcloud/alpha/network-services/route-views/describe @@ -0,0 +1,100 @@ +NAME + gcloud alpha network-services route-views describe - route View for a Mesh + or Gateway + +SYNOPSIS + gcloud alpha network-services route-views describe + (--route-view=ROUTE_VIEW + : --gateway=GATEWAY --location=LOCATION --mesh=MESH) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe a Route Views for a Mesh or Gateway + +EXAMPLES + Describe a Route Views for a Mesh + + $ gcloud alpha network-services route-views describe \ + --project=$PROJECT_ID --location=$LOCATION --mesh mesh1 \ + --route-view $ROUTE_VIEW_ID + $ gcloud alpha network-services route-views describe \ + --route-view=projects/-/locations/-/meshes/-/routeViews/\ + $ROUTE_VIEW_ID + + Describe a Route Views for a Gateway + + $ gcloud alpha network-services route-views describe \ + --project=$PROJECT_ID --location=$LOCATION --gateway gateway1 \ + --route-view $ROUTE_VIEW_ID + $ gcloud alpha network-services route-views describe \ + --route-view=projects/-/locations/-/gateways/-/routeViews/\ + $ROUTE_VIEW_ID + +REQUIRED FLAGS + Mesh or gateway route view resource - RouteView 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 --route-view on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. This resource can be one of the + following types: [networkservices.projects.locations.meshes.routeViews, + networkservices.projects.locations.gateways.routeViews]. + + This must be specified. + + --route-view=ROUTE_VIEW + ID of the mesh_or_gateway_route_view or fully qualified identifier + for the mesh_or_gateway_route_view. + + To set the route_view attribute: + ▸ provide the argument --route-view on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --gateway=GATEWAY + Parent Gateway of the mesh_or_gateway_route_view + + To set the gateway attribute: + ▸ provide the argument --route-view on the command line with a + fully specified name; + ▸ provide the argument --gateway on the command line. Must be + specified for resource of type + [networkservices.projects.locations.gateways.routeViews]. + + --location=LOCATION + Location of the mesh_or_gateway_route_view + + To set the location attribute: + ▸ provide the argument --route-view on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + + --mesh=MESH + Parent Mesh of the mesh_or_gateway_route_view + + To set the mesh attribute: + ▸ provide the argument --route-view on the command line with a + fully specified name; + ▸ provide the argument --mesh on the command line. Must be + specified for resource of type + [networkservices.projects.locations.meshes.routeViews]. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/network-services/route-views/help b/gcloud/alpha/network-services/route-views/help new file mode 100644 index 000000000..db9b87000 --- /dev/null +++ b/gcloud/alpha/network-services/route-views/help @@ -0,0 +1,30 @@ +NAME + gcloud alpha network-services route-views - view Network Services Route + Views + +SYNOPSIS + gcloud alpha network-services route-views COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) View Network Services Route Views. + +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) Route View for a Mesh or Gateway. + + list + (ALPHA) Route View for a Mesh or Gateway. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/network-services/route-views/list b/gcloud/alpha/network-services/route-views/list new file mode 100644 index 000000000..99e649d8b --- /dev/null +++ b/gcloud/alpha/network-services/route-views/list @@ -0,0 +1,119 @@ +NAME + gcloud alpha network-services route-views list - route View for a Mesh or + Gateway + +SYNOPSIS + gcloud alpha network-services route-views list + (--gateway=GATEWAY | --mesh=MESH) [--location=LOCATION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List all Route Views for a Mesh or Gateway + +EXAMPLES + List Route Views for a mesh. + + $ gcloud alpha network-services route-views list \ + --mesh projects/-/locations/-/meshes/mesh1 + $ gcloud alpha network-services route-views list \ + --project $PROJECT --location $LOCATION \ + --mesh projects/-/locations/-/meshes/mesh1 List Route Views \ + for a gateway. + + $ gcloud alpha network-services route-views list \ + --gateway projects/-/locations/-/gateways/gateway1 + $ gcloud alpha network-services route-views list \ + --project $PROJECT --location $LOCATION \ + --gateway projects/-/locations/-/gateways/gateway1 + +REQUIRED FLAGS + Parent of the Route View + + Exactly one of these must be specified: + + Gateway resource - Parent Gateway 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 --gateway on the command line with a fully + specified name; + ▸ set the property core/project; + ▸ provide the argument --project on the command line. + + To set the location attribute: + ▸ provide the argument --gateway on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --gateway=GATEWAY + ID of the gateway or fully qualified identifier for the gateway. + + To set the gateway attribute: + ▫ provide the argument --gateway on the command line. + + Mesh resource - Parent Mesh 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 --mesh on the command line with a fully + specified name; + ▸ set the property core/project; + ▸ provide the argument --project on the command line. + + To set the location attribute: + ▸ provide the argument --mesh on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --mesh=MESH + ID of the mesh or fully qualified identifier for the mesh. + + To set the mesh attribute: + ▫ provide the argument --mesh on the command line. + +FLAGS + Location resource - Location of the parent 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. + + --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 + --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. + +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/pubsub/subscriptions/create b/gcloud/alpha/pubsub/subscriptions/create index 912447f4c..0617de53e 100644 --- a/gcloud/alpha/pubsub/subscriptions/create +++ b/gcloud/alpha/pubsub/subscriptions/create @@ -13,9 +13,10 @@ SYNOPSIS [--push-auth-token-audience=OPTIONAL_AUDIENCE_OVERRIDE] [--push-endpoint=PUSH_ENDPOINT] [--retain-acked-messages] [[--bigquery-table=BIGQUERY_TABLE - : --drop-unknown-fields --write-metadata --use-table-schema + : --bigquery-service-account-email=BIGQUERY_SERVICE_ACCOUNT_EMAIL + --drop-unknown-fields --write-metadata --use-table-schema | --use-topic-schema] | [--cloud-storage-bucket=CLOUD_STORAGE_BUCKET - : --cloud-storage-file-datetime-format=CLOUD_STORAGE_FILE_DATETIME_FORMAT --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX --cloud-storage-max-bytes=CLOUD_STORAGE_MAX_BYTES --cloud-storage-max-duration=CLOUD_STORAGE_MAX_DURATION --cloud-storage-output-format=OUTPUT_FORMAT; default="text" --cloud-storage-write-metadata]] + : --cloud-storage-file-datetime-format=CLOUD_STORAGE_FILE_DATETIME_FORMAT --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX --cloud-storage-max-bytes=CLOUD_STORAGE_MAX_BYTES --cloud-storage-max-duration=CLOUD_STORAGE_MAX_DURATION --cloud-storage-output-format=OUTPUT_FORMAT; default="text" --cloud-storage-service-account-email=CLOUD_STORAGE_SERVICE_ACCOUNT_EMAIL --cloud-storage-write-metadata]] [--max-delivery-attempts=MAX_DELIVERY_ATTEMPTS [--dead-letter-topic=DEAD_LETTER_TOPIC : --dead-letter-topic-project=DEAD_LETTER_TOPIC_PROJECT]] @@ -160,6 +161,11 @@ OPTIONAL FLAGS This flag argument must be specified if any of the other arguments in this group are specified. + --bigquery-service-account-email=BIGQUERY_SERVICE_ACCOUNT_EMAIL + The service account email to use when writing to BigQuery. If + unspecified, uses the Pub/Sub service agent + (https://cloud.google.com/iam/docs/service-account-types#service-agents). + --drop-unknown-fields If either --use-topic-schema or --use-table-schema is set, whether or not to ignore fields in the message that do not appear in the @@ -231,6 +237,11 @@ OPTIONAL FLAGS avro (messages will be written as an Avro binary). OUTPUT_FORMAT must be one of: text, avro. + --cloud-storage-service-account-email=CLOUD_STORAGE_SERVICE_ACCOUNT_EMAIL + The service account email to use when writing to Cloud Storage. If + unspecified, uses the Pub/Sub service agent + (https://cloud.google.com/iam/docs/service-account-types#service-agents). + --cloud-storage-write-metadata Whether or not to write the subscription name, message_id, publish_time, attributes, and ordering_key as additional fields in diff --git a/gcloud/alpha/pubsub/subscriptions/update b/gcloud/alpha/pubsub/subscriptions/update index f2c5bed88..773d30470 100644 --- a/gcloud/alpha/pubsub/subscriptions/update +++ b/gcloud/alpha/pubsub/subscriptions/update @@ -12,10 +12,11 @@ SYNOPSIS [--push-endpoint=PUSH_ENDPOINT] [--retain-acked-messages] [--update-labels=[KEY=VALUE,...]] [--clear-bigquery-config | [--bigquery-table=BIGQUERY_TABLE - : --drop-unknown-fields --write-metadata --use-table-schema + : --bigquery-service-account-email=BIGQUERY_SERVICE_ACCOUNT_EMAIL + --drop-unknown-fields --write-metadata --use-table-schema | --use-topic-schema] | --clear-cloud-storage-config | [--cloud-storage-bucket=CLOUD_STORAGE_BUCKET - : --cloud-storage-file-datetime-format=CLOUD_STORAGE_FILE_DATETIME_FORMAT --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX --cloud-storage-max-bytes=CLOUD_STORAGE_MAX_BYTES --cloud-storage-max-duration=CLOUD_STORAGE_MAX_DURATION --cloud-storage-output-format=OUTPUT_FORMAT; default="text" --cloud-storage-write-metadata]] + : --cloud-storage-file-datetime-format=CLOUD_STORAGE_FILE_DATETIME_FORMAT --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX --cloud-storage-max-bytes=CLOUD_STORAGE_MAX_BYTES --cloud-storage-max-duration=CLOUD_STORAGE_MAX_DURATION --cloud-storage-output-format=OUTPUT_FORMAT; default="text" --cloud-storage-service-account-email=CLOUD_STORAGE_SERVICE_ACCOUNT_EMAIL --cloud-storage-write-metadata]] [--clear-dead-letter-policy | --max-delivery-attempts=MAX_DELIVERY_ATTEMPTS [--dead-letter-topic=DEAD_LETTER_TOPIC @@ -130,6 +131,11 @@ FLAGS This flag argument must be specified if any of the other arguments in this group are specified. + --bigquery-service-account-email=BIGQUERY_SERVICE_ACCOUNT_EMAIL + The service account email to use when writing to BigQuery. If + unspecified, uses the Pub/Sub service agent + (https://cloud.google.com/iam/docs/service-account-types#service-agents). + --drop-unknown-fields If either --use-topic-schema or --use-table-schema is set, whether or not to ignore fields in the message that do not appear @@ -211,6 +217,11 @@ FLAGS avro (messages will be written as an Avro binary). OUTPUT_FORMAT must be one of: text, avro. + --cloud-storage-service-account-email=CLOUD_STORAGE_SERVICE_ACCOUNT_EMAIL + The service account email to use when writing to Cloud Storage. + If unspecified, uses the Pub/Sub service agent + (https://cloud.google.com/iam/docs/service-account-types#service-agents). + --cloud-storage-write-metadata Whether or not to write the subscription name, message_id, publish_time, attributes, and ordering_key as additional fields diff --git a/gcloud/alpha/spanner/databases/change-quorum b/gcloud/alpha/spanner/databases/change-quorum new file mode 100644 index 000000000..ffa8e8245 --- /dev/null +++ b/gcloud/alpha/spanner/databases/change-quorum @@ -0,0 +1,107 @@ +NAME + gcloud alpha spanner databases change-quorum - change quorum of a Cloud + Spanner database + +SYNOPSIS + gcloud alpha spanner databases change-quorum + (DATABASE : --instance=INSTANCE) + (--dual-region | --serving-location=SERVING_LOCATION --single-region) + [--etag=ETAG] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Change quorum of a Cloud Spanner database. + +EXAMPLES + To trigger change quorum from single-region mode to dual-region mode, run: + + $ gcloud alpha spanner databases change-quorum my-database-id \ + --instance=my-instance-id --dual-region + + To trigger change quorum from dual-region mode to single-region mode with + serving location as asia-south1, run: + + $ gcloud alpha spanner databases change-quorum my-database-id \ + --instance=my-instance-id --single-region \ + --serving-location=asia-south1 + + To trigger change quorum using etag specified, run: + + $ gcloud alpha spanner databases change-quorum my-database-id \ + --instance=my-instance-id --dual-region --etag=ETAG + +POSITIONAL ARGUMENTS + Database resource - The Cloud Spanner database to change quorum. 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 database 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. + + DATABASE + ID of the database or fully qualified identifier for the database. + + To set the database attribute: + ▸ provide the argument database on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --instance=INSTANCE + The Cloud Spanner instance for the database. + + To set the instance attribute: + ▸ provide the argument database on the command line with a fully + specified name; + ▸ provide the argument --instance on the command line; + ▸ set the property spanner/instance. + +REQUIRED FLAGS + Exactly one of these must be specified: + + Command-line flag for dual-region quorum change: + + --dual-region + Switch to dual-region quorum type. + + Command-line flags for single-region quorum change: + + --serving-location=SERVING_LOCATION + The cloud Spanner location. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --single-region + Switch to single-region quorum type. + + This flag argument must be specified if any of the other arguments + in this group are specified. + +OPTIONAL FLAGS + --etag=ETAG + Used for optimistic concurrency control. + +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. These variants are also available: + + $ gcloud spanner databases change-quorum + + $ gcloud beta spanner databases change-quorum + diff --git a/gcloud/alpha/spanner/databases/create b/gcloud/alpha/spanner/databases/create index 5f59fc2df..b809ddb49 100644 --- a/gcloud/alpha/spanner/databases/create +++ b/gcloud/alpha/spanner/databases/create @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud alpha spanner databases create (DATABASE : --instance=INSTANCE) [--async] [--database-dialect=DATABASE_DIALECT] [--ddl=DDL] - [--ddl-file=DDL_FILE] + [--ddl-file=DDL_FILE] [--proto-descriptors-file=PROTO_DESCRIPTORS_FILE] [--kms-key=KMS_KEY : --kms-keyring=KMS_KEYRING --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT] [GCLOUD_WIDE_FLAG ...] @@ -87,6 +87,11 @@ FLAGS --ddl_file is set, --ddl is ignored. One line comments starting with -- are ignored. + --proto-descriptors-file=PROTO_DESCRIPTORS_FILE + Path of a file that contains a protobuf-serialized + google.protobuf.FileDescriptorSet message. To generate it, install and + run protoc with --include_imports and --descriptor_set_out. + KMS key name group At most one of these can be specified: diff --git a/gcloud/alpha/spanner/databases/ddl/describe b/gcloud/alpha/spanner/databases/ddl/describe index 98fdbbb9c..9973b89e7 100644 --- a/gcloud/alpha/spanner/databases/ddl/describe +++ b/gcloud/alpha/spanner/databases/ddl/describe @@ -4,9 +4,9 @@ NAME SYNOPSIS gcloud alpha spanner databases ddl describe - (DATABASE : --instance=INSTANCE) [--filter=EXPRESSION] [--limit=LIMIT] - [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] - [GCLOUD_WIDE_FLAG ...] + (DATABASE : --instance=INSTANCE) [--include-proto-descriptors] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Describe the DDL for a Cloud Spanner database. @@ -49,6 +49,11 @@ POSITIONAL ARGUMENTS ▸ provide the argument --instance on the command line; ▸ set the property spanner/instance. +FLAGS + --include-proto-descriptors + Include debug string of proto bundle descriptors in the output. The + output is information only and not meant to be parsed. + LIST COMMAND FLAGS --filter=EXPRESSION Apply a Boolean filter EXPRESSION to each resource item to be listed. diff --git a/gcloud/alpha/spanner/databases/ddl/update b/gcloud/alpha/spanner/databases/ddl/update index 940ba44a8..5257d744c 100644 --- a/gcloud/alpha/spanner/databases/ddl/update +++ b/gcloud/alpha/spanner/databases/ddl/update @@ -4,7 +4,9 @@ NAME SYNOPSIS gcloud alpha spanner databases ddl update (DATABASE : --instance=INSTANCE) - [--async] [--ddl=DDL] [--ddl-file=DDL_FILE] [GCLOUD_WIDE_FLAG ...] + [--async] [--ddl=DDL] [--ddl-file=DDL_FILE] + [--proto-descriptors-file=PROTO_DESCRIPTORS_FILE] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Update the DDL for a Cloud Spanner database. @@ -65,6 +67,11 @@ FLAGS --ddl_file is set, --ddl is ignored. One line comments starting with -- are ignored. + --proto-descriptors-file=PROTO_DESCRIPTORS_FILE + Path of a file that contains a protobuf-serialized + google.protobuf.FileDescriptorSet message. To generate it, install and + run protoc with --include_imports and --descriptor_set_out. + 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/spanner/databases/help b/gcloud/alpha/spanner/databases/help index 52e28ff05..b549f0543 100644 --- a/gcloud/alpha/spanner/databases/help +++ b/gcloud/alpha/spanner/databases/help @@ -33,6 +33,9 @@ COMMANDS add-iam-policy-binding (ALPHA) Add IAM policy binding to a Cloud Spanner database. + change-quorum + (ALPHA) Change quorum of a Cloud Spanner database. + create (ALPHA) Create a Cloud Spanner database. diff --git a/gcloud/alpha/spanner/operations/cancel b/gcloud/alpha/spanner/operations/cancel index 6cdb8b444..deeaa2a0d 100644 --- a/gcloud/alpha/spanner/operations/cancel +++ b/gcloud/alpha/spanner/operations/cancel @@ -1,6 +1,5 @@ NAME gcloud alpha spanner operations cancel - cancel a Cloud Spanner operation - with ALPHA features SYNOPSIS gcloud alpha spanner operations cancel OPERATION-ID @@ -8,7 +7,7 @@ SYNOPSIS [--backup=BACKUP] [--database=DATABASE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Cancel a Cloud Spanner operation with ALPHA features. + (ALPHA) Cancel a Cloud Spanner operation. EXAMPLES To cancel an instance operation with ID auto_12345, run: diff --git a/gcloud/alpha/spanner/operations/describe b/gcloud/alpha/spanner/operations/describe index 05b611009..e2894209b 100644 --- a/gcloud/alpha/spanner/operations/describe +++ b/gcloud/alpha/spanner/operations/describe @@ -1,6 +1,6 @@ NAME gcloud alpha spanner operations describe - describe a Cloud Spanner - operation with ALPHA features + operation SYNOPSIS gcloud alpha spanner operations describe OPERATION-ID @@ -8,7 +8,7 @@ SYNOPSIS [--backup=BACKUP] [--database=DATABASE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Describe a Cloud Spanner operation with ALPHA features. + (ALPHA) Describe a Cloud Spanner operation. EXAMPLES To describe a Cloud Spanner instance operation, run: diff --git a/gcloud/alpha/spanner/operations/help b/gcloud/alpha/spanner/operations/help index bb6918453..1262080bb 100644 --- a/gcloud/alpha/spanner/operations/help +++ b/gcloud/alpha/spanner/operations/help @@ -16,13 +16,13 @@ COMMANDS COMMAND is one of the following: cancel - (ALPHA) Cancel a Cloud Spanner operation with ALPHA features. + (ALPHA) Cancel a Cloud Spanner operation. describe - (ALPHA) Describe a Cloud Spanner operation with ALPHA features. + (ALPHA) Describe a Cloud Spanner operation. list - (ALPHA) List the Cloud Spanner operations with ALPHA features. + (ALPHA) List the Cloud Spanner operations. NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/spanner/operations/list b/gcloud/alpha/spanner/operations/list index 0d8ea8dde..ca93de477 100644 --- a/gcloud/alpha/spanner/operations/list +++ b/gcloud/alpha/spanner/operations/list @@ -1,6 +1,5 @@ NAME gcloud alpha spanner operations list - list the Cloud Spanner operations - with ALPHA features SYNOPSIS gcloud alpha spanner operations list @@ -10,7 +9,7 @@ SYNOPSIS [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) List the Cloud Spanner operations with ALPHA features. + (ALPHA) List the Cloud Spanner operations. EXAMPLES To list Cloud Spanner instance operations for an instance, run: diff --git a/gcloud/alpha/workstations/configs/create b/gcloud/alpha/workstations/configs/create index 13d203723..ff593289e 100644 --- a/gcloud/alpha/workstations/configs/create +++ b/gcloud/alpha/workstations/configs/create @@ -4,7 +4,8 @@ NAME SYNOPSIS gcloud alpha workstations configs create - (CONFIG : --cluster=CLUSTER --region=REGION) [--async] + (CONFIG : --cluster=CLUSTER --region=REGION) + [--allowed-ports=[ALLOWED_PORTS,...]] [--async] [--boost-config=[BOOST_CONFIG,...]] [--boot-disk-size=BOOT_DISK_SIZE; default=50] [--container-args=[CONTAINER_ARGS,...]] @@ -101,6 +102,39 @@ POSITIONAL ARGUMENTS ▸ set the property workstations/region. FLAGS + --allowed-ports=[ALLOWED_PORTS,...] + A Single or Range of ports externally accessible in the workstation. If + not specified defaults to ports 22, 80 and ports 1024-65535. + + To specify a single port, both first and last should be same. + + Example: + + $ gcloud alpha workstations configs create \ + --allowed-ports=first=9000,last=9090 + $ gcloud alpha workstations configs create \ + --allowed-ports=first=80,last=80 + + Sets allowed_ports value. + + first + Required, Sets first value. + + last + Required, Sets last value. + + Shorthand Example: + + --allowed-ports=first=int,last=int + + JSON Example: + + --allowed-ports='{"first": int, "last": int}' + + File Example: + + --allowed-ports=path_to_file.(yaml|json) + --async Return immediately, without waiting for the operation in progress to complete. @@ -108,7 +142,8 @@ FLAGS --boost-config=[BOOST_CONFIG,...] Boost Configuration(s) that workstations running with this configuration can boost up to. This includes id (required), - machine-type, accelerator-type, and accelerator-count. + machine-type, accelerator-type, accelerator-count, pool-size, + boot-disk-size, and enable-nested-virtualization. Example: @@ -124,19 +159,28 @@ FLAGS accelerator-type Sets accelerator-type value. + boot-disk-size + Sets boot-disk-size value. + + enable-nested-virtualization + Sets enable-nested-virtualization value. + id Required, Sets id value. machine-type Sets machine-type value. + pool-size + Sets pool-size value. + Shorthand Example: - --boost-config=accelerator-count=int,accelerator-type=string,id=string,machine-type=string + --boost-config=accelerator-count=int,accelerator-type=string,boot-disk-size=int,enable-nested-virtualization=boolean,id=string,machine-type=string,pool-size=int JSON Example: - --boost-config='{"accelerator-count": int, "accelerator-type": "string", "id": "string", "machine-type": "string"}' + --boost-config='{"accelerator-count": int, "accelerator-type": "string", "boot-disk-size": int, "enable-nested-virtualization": boolean, "id": "string", "machine-type": "string", "pool-size": int}' File Example: diff --git a/gcloud/alpha/workstations/configs/update b/gcloud/alpha/workstations/configs/update index 610c4c44b..a3e9a0cb5 100644 --- a/gcloud/alpha/workstations/configs/update +++ b/gcloud/alpha/workstations/configs/update @@ -4,7 +4,8 @@ NAME SYNOPSIS gcloud alpha workstations configs update - (CONFIG : --cluster=CLUSTER --region=REGION) [--async] + (CONFIG : --cluster=CLUSTER --region=REGION) + [--allowed-ports=[ALLOWED_PORTS,...]] [--async] [--boost-config=[BOOST_CONFIG,...]] [--boot-disk-size=BOOT_DISK_SIZE] [--container-args=[CONTAINER_ARGS,...]] [--container-command=[CONTAINER_COMMAND,...]] @@ -88,6 +89,39 @@ POSITIONAL ARGUMENTS ▸ set the property workstations/region. FLAGS + --allowed-ports=[ALLOWED_PORTS,...] + A Single or Range of ports externally accessible in the workstation. If + not specified defaults to ports 22, 80 and ports 1024-65535. + + To specify a single port, both first and last should be same. + + Example: + + $ gcloud alpha workstations configs update \ + --allowed-ports=first=9000,last=9090 + $ gcloud alpha workstations configs update \ + --allowed-ports=first=80,last=80 + + Sets allowed_ports value. + + first + Required, Sets first value. + + last + Required, Sets last value. + + Shorthand Example: + + --allowed-ports=first=int,last=int + + JSON Example: + + --allowed-ports='{"first": int, "last": int}' + + File Example: + + --allowed-ports=path_to_file.(yaml|json) + --async Return immediately, without waiting for the operation in progress to complete. @@ -95,7 +129,8 @@ FLAGS --boost-config=[BOOST_CONFIG,...] Boost Configuration(s) that workstations running with this configuration can boost up to. This includes id (required), - machine-type, accelerator-type, and accelerator-count. + machine-type, accelerator-type, accelerator-count, pool-size, + boot-disk-size, and enable-nested-virtualization. Example: @@ -111,19 +146,28 @@ FLAGS accelerator-type Sets accelerator-type value. + boot-disk-size + Sets boot-disk-size value. + + enable-nested-virtualization + Sets enable-nested-virtualization value. + id Required, Sets id value. machine-type Sets machine-type value. + pool-size + Sets pool-size value. + Shorthand Example: - --boost-config=accelerator-count=int,accelerator-type=string,id=string,machine-type=string + --boost-config=accelerator-count=int,accelerator-type=string,boot-disk-size=int,enable-nested-virtualization=boolean,id=string,machine-type=string,pool-size=int JSON Example: - --boost-config='{"accelerator-count": int, "accelerator-type": "string", "id": "string", "machine-type": "string"}' + --boost-config='{"accelerator-count": int, "accelerator-type": "string", "boot-disk-size": int, "enable-nested-virtualization": boolean, "id": "string", "machine-type": "string", "pool-size": int}' File Example: diff --git a/gcloud/artifacts/files/delete b/gcloud/artifacts/files/delete new file mode 100644 index 000000000..e46abb275 --- /dev/null +++ b/gcloud/artifacts/files/delete @@ -0,0 +1,84 @@ +NAME + gcloud artifacts files delete - delete an Artifact Registry file + +SYNOPSIS + gcloud artifacts files delete + (FILE : --location=LOCATION --repository=REPOSITORY) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete an Artifact Registry file. + + This command can fail for the following reasons: + ▪ The specified file does not exist. + ▪ The active account does not have permission to delete files. + ▪ The repository is not a Generic repository. + +EXAMPLES + To delete a file named pkg:1.0.0:file1.txt under the current project, + repository, and location, run: + + $ gcloud artifacts files delete pkg:v0.0.1:file1.txt + +POSITIONAL ARGUMENTS + File resource - The Artifact Registry file 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 file 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. + + FILE + ID of the file or fully qualified identifier for the file. + + To set the file attribute: + ▸ provide the argument file 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 file. Overrides the default artifacts/location + property value for this command invocation. To configure the default + location, use the command: gcloud config set artifacts/location. + + To set the location attribute: + ▸ provide the argument file on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property artifacts/location. + + --repository=REPOSITORY + The repository associated with the file. Overrides the default + artifacts/repository property value for this command invocation. To + configure the default repository, use the command: gcloud config set + artifacts/repository. + + To set the repository attribute: + ▸ provide the argument file on the command line with a fully + specified name; + ▸ provide the argument --repository on the command line; + ▸ set the property artifacts/repository. + +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 artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ diff --git a/gcloud/artifacts/files/help b/gcloud/artifacts/files/help index 7bfb2af26..c89152ce0 100644 --- a/gcloud/artifacts/files/help +++ b/gcloud/artifacts/files/help @@ -23,6 +23,9 @@ GCLOUD WIDE FLAGS COMMANDS COMMAND is one of the following: + delete + Delete an Artifact Registry file. + describe Describe an Artifact Registry file. diff --git a/gcloud/beta/compute/backend-services/create b/gcloud/beta/compute/backend-services/create index 3ea9b9ff8..4350a8a08 100644 --- a/gcloud/beta/compute/backend-services/create +++ b/gcloud/beta/compute/backend-services/create @@ -527,17 +527,26 @@ FLAGS If the load-balancing-scheme is INTERNAL_MANAGED (Internal Application Load Balancer), the protocol must be one of: HTTP, HTTPS, HTTP2. + If the load-balancing-scheme is INTERNAL_MANAGED (Internal proxy + Network Load Balancer), the protocol must be only TCP. + If the load-balancing-scheme is EXTERNAL and region is not set (Classic - Application Load Balancer and global external proxy Network Load - Balancer), the protocol must be one of: HTTP, HTTPS, HTTP2, SSL, TCP. + Application Load Balancer and Classic proxy Network Load Balancer), the + protocol must be one of: HTTP, HTTPS, HTTP2, TCP, SSL. If the load-balancing-scheme is EXTERNAL and region is set (External passthrough Network Load Balancer), the protocol must be one of: TCP, UDP, UNSPECIFIED. - If the load-balancing-scheme is EXTERNAL_MANAGED (Envoy based Global - and regional external Application Load Balancers), the protocol must be - one of: HTTP, HTTPS, HTTP2. + If the load-balancing-scheme is EXTERNAL_MANAGED (Global external + Application Load Balancer and regional external Application Load + Balancer), the protocol must be one of: HTTP, HTTPS, HTTP2. + + If the load-balancing-scheme is EXTERNAL_MANAGED (Global external proxy + Network Load Balancer), the protocol must be one of: TCP, SSL. + + If the load-balancing-scheme is EXTERNAL_MANAGED (Regional external + proxy Network Load Balancer), the protocol must be only TCP. --[no-]request-coalescing Enables request coalescing to the backend (recommended). diff --git a/gcloud/beta/compute/backend-services/update b/gcloud/beta/compute/backend-services/update index 28f408d44..81060e5f9 100644 --- a/gcloud/beta/compute/backend-services/update +++ b/gcloud/beta/compute/backend-services/update @@ -349,17 +349,26 @@ FLAGS If the load-balancing-scheme is INTERNAL_MANAGED (Internal Application Load Balancer), the protocol must be one of: HTTP, HTTPS, HTTP2. + If the load-balancing-scheme is INTERNAL_MANAGED (Internal proxy + Network Load Balancer), the protocol must be only TCP. + If the load-balancing-scheme is EXTERNAL and region is not set (Classic - Application Load Balancer and global external proxy Network Load - Balancer), the protocol must be one of: HTTP, HTTPS, HTTP2, SSL, TCP. + Application Load Balancer and Classic proxy Network Load Balancer), the + protocol must be one of: HTTP, HTTPS, HTTP2, TCP, SSL. If the load-balancing-scheme is EXTERNAL and region is set (External passthrough Network Load Balancer), the protocol must be one of: TCP, UDP, UNSPECIFIED. - If the load-balancing-scheme is EXTERNAL_MANAGED (Envoy based Global - and regional external Application Load Balancers), the protocol must be - one of: HTTP, HTTPS, HTTP2. + If the load-balancing-scheme is EXTERNAL_MANAGED (Global external + Application Load Balancer and regional external Application Load + Balancer), the protocol must be one of: HTTP, HTTPS, HTTP2. + + If the load-balancing-scheme is EXTERNAL_MANAGED (Global external proxy + Network Load Balancer), the protocol must be one of: TCP, SSL. + + If the load-balancing-scheme is EXTERNAL_MANAGED (Regional external + proxy Network Load Balancer), the protocol must be only TCP. --[no-]request-coalescing Enables request coalescing to the backend (recommended). diff --git a/gcloud/beta/compute/commitments/create b/gcloud/beta/compute/commitments/create index d3c78c046..bbc2e3e99 100644 --- a/gcloud/beta/compute/commitments/create +++ b/gcloud/beta/compute/commitments/create @@ -234,14 +234,13 @@ OPTIONAL FLAGS --share-setting=SHARE_SETTING Specify if this reservation is shared, and if so, the type of sharing. If you omit this flag, this value is local (not shared) - by default. SHARE_SETTING must be one of: local, projects, - folders. + by default. SHARE_SETTING must be one of: local, projects. --share-with=SHARE_WITH,[SHARE_WITH,...] If this reservation is shared (--share-setting is not local), - provide a list of all of the specific projects or folders that - this reservation is shared with. List must contain project IDs or - project numbers or folder IDs. + provide a list of all of the specific projects that this + reservation is shared with. List must contain project IDs or + project numbers. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/compute/commitments/update-reservations b/gcloud/beta/compute/commitments/update-reservations index 84c161735..3813de44e 100644 --- a/gcloud/beta/compute/commitments/update-reservations +++ b/gcloud/beta/compute/commitments/update-reservations @@ -156,14 +156,13 @@ FLAGS --dest-share-setting=DEST_SHARE_SETTING Specify if this reservation is shared, and if so, the type of sharing. If you omit this flag, this value is local (not shared) by - default. DEST_SHARE_SETTING must be one of: local, projects, - folders. + default. DEST_SHARE_SETTING must be one of: local, projects. --dest-share-with=SHARE_WITH,[SHARE_WITH,...] If this reservation is shared (--share-setting is not local), - provide a list of all of the specific projects or folders that this + provide a list of all of the specific projects that this reservation is shared with. List must contain project IDs or - project numbers or folder IDs. + project numbers. --source-accelerator=[count=COUNT],[type=TYPE] Manage the configuration of the type and number of accelerator @@ -192,14 +191,13 @@ FLAGS --source-share-setting=SOURCE_SHARE_SETTING Specify if this reservation is shared, and if so, the type of sharing. If you omit this flag, this value is local (not shared) by - default. SOURCE_SHARE_SETTING must be one of: local, projects, - folders. + default. SOURCE_SHARE_SETTING must be one of: local, projects. --source-share-with=SHARE_WITH,[SHARE_WITH,...] If this reservation is shared (--share-setting is not local), - provide a list of all of the specific projects or folders that this + provide a list of all of the specific projects that this reservation is shared with. List must contain project IDs or - project numbers or folder IDs. + project numbers. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/compute/disks/create b/gcloud/beta/compute/disks/create index 28ff1cc9c..67b56212d 100644 --- a/gcloud/beta/compute/disks/create +++ b/gcloud/beta/compute/disks/create @@ -3,9 +3,9 @@ NAME SYNOPSIS gcloud beta compute disks create DISK_NAME [DISK_NAME ...] - [--architecture=ARCHITECTURE] [--confidential-compute] - [--csek-key-file=FILE] [--description=DESCRIPTION] - [--erase-windows-vss-signature] + [--access-mode=ACCESS_MODE] [--architecture=ARCHITECTURE] + [--confidential-compute] [--csek-key-file=FILE] + [--description=DESCRIPTION] [--erase-windows-vss-signature] [--guest-os-features=[GUEST_OS_FEATURE,...]] [--interface=INTERFACE] [--labels=[KEY=VALUE,...]] [--licenses=[LICENSE,...]] [--multi-writer] [--physical-block-size=PHYSICAL_BLOCK_SIZE; default="4096"] @@ -61,6 +61,14 @@ POSITIONAL ARGUMENTS https://cloud.google.com/compute/docs/naming-resources FLAGS + --access-mode=ACCESS_MODE + Specifie how VMs attached to the disk can access the data on the disk. + To grant read-only access to multiple VMs attached to the disk, set + access-mode to READ_ONLY_MANY. To grant read-write access to only one + VM attached to the disk, use READ_WRITE_SINGLE. READ_WRITE_SINGLE is + used if omitted. ACCESS_MODE must be one of: READ_ONLY_MANY, + READ_WRITE_MANY, READ_WRITE_SINGLE. + --architecture=ARCHITECTURE Specifies the architecture or processor type that this disk can support. For available processor types on Compute Engine, see diff --git a/gcloud/beta/compute/disks/update b/gcloud/beta/compute/disks/update index 966e5caee..a17a448d4 100644 --- a/gcloud/beta/compute/disks/update +++ b/gcloud/beta/compute/disks/update @@ -2,7 +2,7 @@ NAME gcloud beta compute disks update - update a Compute Engine persistent disk SYNOPSIS - gcloud beta compute disks update DISK_NAME + gcloud beta compute disks update DISK_NAME [--access-mode=ACCESS_MODE] [--provisioned-iops=PROVISIONED_IOPS] [--provisioned-throughput=PROVISIONED_THROUGHPUT] [--size=SIZE] [--update-labels=[KEY=VALUE,...]] @@ -40,6 +40,14 @@ POSITIONAL ARGUMENTS Name of the disk to update. FLAGS + --access-mode=ACCESS_MODE + Specifie how VMs attached to the disk can access the data on the disk. + To grant read-only access to multiple VMs attached to the disk, set + access-mode to READ_ONLY_MANY. To grant read-write access to only one + VM attached to the disk, use READ_WRITE_SINGLE. READ_WRITE_SINGLE is + used if omitted. ACCESS_MODE must be one of: READ_ONLY_MANY, + READ_WRITE_MANY, READ_WRITE_SINGLE. + --provisioned-iops=PROVISIONED_IOPS Provisioned IOPS of disk to update. Only for use with disks of type hyperdisk-extreme. diff --git a/gcloud/beta/compute/images/import b/gcloud/beta/compute/images/import index 20e43a2da..8ff44d81d 100644 --- a/gcloud/beta/compute/images/import +++ b/gcloud/beta/compute/images/import @@ -23,6 +23,9 @@ DESCRIPTION (BETA) gcloud beta compute images import imports Virtual Disk images, such as VMWare VMDK files and VHD files, into Compute Engine. + NOTE: It is recommended to use the new Image Import. Run "gcloud alpha + migration vms image-imports --help" for details. + Importing images involves four steps: ▪ Upload the virtual disk file to Cloud Storage. ▪ Import the image to Compute Engine. @@ -47,6 +50,15 @@ DESCRIPTION See https://cloud.google.com/compute/docs/images/importing-virtual-disks#resource_cleanup. + Troubleshooting: Image import/export tools rely on CloudBuild default + behavior. They has been using the default CloudBuild service account in + order to import/export images to/from Google Cloud Platform. However, Cloud + Build has changed this default behavior and in new projects a custom user + managed service account may need to be provided to perform the builds. If + you get a CloudBuild service account related error, run gcloud with + --cloudbuild-service-account=. See gcloud compute + images import --help for details. + EXAMPLES To import a centos-7 VMDK file, run: diff --git a/gcloud/beta/compute/instances/ops-agents/policies/create b/gcloud/beta/compute/instances/ops-agents/policies/create index 955d4cd57..5ef85b123 100644 --- a/gcloud/beta/compute/instances/ops-agents/policies/create +++ b/gcloud/beta/compute/instances/ops-agents/policies/create @@ -248,6 +248,7 @@ REQUIRED FLAGS ubuntu 22.04 ubuntu 23.04 ubuntu 23.10 + ubuntu 24.04 windows 10.* windows 6.* diff --git a/gcloud/beta/compute/instances/ops-agents/policies/update b/gcloud/beta/compute/instances/ops-agents/policies/update index bacd0c27b..ec2a04e58 100644 --- a/gcloud/beta/compute/instances/ops-agents/policies/update +++ b/gcloud/beta/compute/instances/ops-agents/policies/update @@ -285,6 +285,7 @@ FLAGS ubuntu 22.04 ubuntu 23.04 ubuntu 23.10 + ubuntu 24.04 windows 10.* windows 6.* diff --git a/gcloud/beta/compute/network-endpoint-groups/create b/gcloud/beta/compute/network-endpoint-groups/create index ce09adef4..cb647ab28 100644 --- a/gcloud/beta/compute/network-endpoint-groups/create +++ b/gcloud/beta/compute/network-endpoint-groups/create @@ -57,7 +57,7 @@ FLAGS This is only supported for NEGs with endpoint type gce-vm-ip-port, non-gcp-private-ip-port, gce-vm-ip, private-service-connect, - internet-ip-port, or internet-fqdn-port. + internet-ip-port, internet-fqdn-port, or gce-vm-ip-portmap. For Private Service Connect NEGs, you can optionally specify --network and --subnet if --psc-target-service points to a published service. If @@ -112,9 +112,15 @@ FLAGS optional. If unspecified, the primary NIC address is used. A port must not be specified. + gce-vm-ip-portmap + Endpoint IP address must be a primary IP of a VM's network + interface in Compute Engine. The --default-port must be specified + or every network endpoint in the network endpoint group must have a + port specified. + NETWORK_ENDPOINT_TYPE must be one of: gce-vm-ip-port, internet-ip-port, internet-fqdn-port, non-gcp-private-ip-port, - serverless, gce-vm-ip, private-service-connect. + serverless, gce-vm-ip, private-service-connect, gce-vm-ip-portmap. --producer-port=PRODUCER_PORT The psc producer port to use when consumer PSC NEG connects to a @@ -138,9 +144,9 @@ FLAGS region where the network endpoint group is created. This is only supported for NEGs with endpoint type gce-vm-ip-port, - gce-vm-ip, or private-service-connect. For Private Service Connect - NEGs, you can optionally specify --network and --subnet if - --psc-target-service points to a published service. If + gce-vm-ip, private-service-connect, or gce-vm-ip-portmap. For Private + Service Connect NEGs, you can optionally specify --network and --subnet + if --psc-target-service points to a published service. If --psc-target-service points to the regional service endpoint of a Google API, do not specify --network or --subnet. diff --git a/gcloud/beta/compute/network-endpoint-groups/update b/gcloud/beta/compute/network-endpoint-groups/update index e7064d941..8c401beb7 100644 --- a/gcloud/beta/compute/network-endpoint-groups/update +++ b/gcloud/beta/compute/network-endpoint-groups/update @@ -4,9 +4,10 @@ NAME SYNOPSIS gcloud beta compute network-endpoint-groups update NAME - (--add-endpoint=[fqdn=FQDN],[instance=INSTANCE],[ip=IP],[port=PORT] - | --remove-endpoint=[fqdn=FQDN], - [instance=INSTANCE],[ip=IP],[port=PORT]) + (--add-endpoint=[client-destination-port=CLIENT-DESTINATION-PORT], + [fqdn=FQDN],[instance=INSTANCE],[ip=IP],[port=PORT] + | --remove-endpoint=[client-destination-port=CLIENT-DESTINATION-PORT], + [fqdn=FQDN],[instance=INSTANCE],[ip=IP],[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=[client-destination-port=CLIENT-DESTINATION-PORT],[fqdn=FQDN],[instance=INSTANCE],[ip=IP],[port=PORT] The network endpoint to add to the network endpoint group. Keys used depend on the endpoint type of the NEG. @@ -60,6 +61,9 @@ REQUIRED FLAGS *port* - Required endpoint port unless NEG default port is set. + *client-destination-port* - Required endpoint client destination port only for the port + mapping NEG. + internet-ip-port *ip* - Required IPv4 address of the endpoint to attach. Must be @@ -107,7 +111,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=[client-destination-port=CLIENT-DESTINATION-PORT],[fqdn=FQDN],[instance=INSTANCE],[ip=IP],[port=PORT] The network endpoint to detach from the network endpoint group. Keys used depend on the endpoint type of the NEG. @@ -122,6 +126,8 @@ REQUIRED FLAGS *port* - Optional port of the network endpoint to detach. + *client-destination-port* - Optional client destination port, only for port mapping NEGs. + internet-ip-port *ip* - Required IPv4 address of the network endpoint to detach. diff --git a/gcloud/beta/compute/reservations/create b/gcloud/beta/compute/reservations/create index e513163ab..0d959958e 100644 --- a/gcloud/beta/compute/reservations/create +++ b/gcloud/beta/compute/reservations/create @@ -163,13 +163,12 @@ OPTIONAL FLAGS --share-setting=SHARE_SETTING Specify if this reservation is shared, and if so, the type of sharing. If you omit this flag, this value is local (not shared) by - default. SHARE_SETTING must be one of: local, projects, folders. + default. SHARE_SETTING must be one of: local, projects. --share-with=SHARE_WITH,[SHARE_WITH,...] If this reservation is shared (--share-setting is not local), provide - a list of all of the specific projects or folders that this - reservation is shared with. List must contain project IDs or project - numbers or folder IDs. + a list of all of the specific projects that this reservation is + shared with. List must contain project IDs or project numbers. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/compute/reservations/update b/gcloud/beta/compute/reservations/update index 3f40a2f17..1d3480fdb 100644 --- a/gcloud/beta/compute/reservations/update +++ b/gcloud/beta/compute/reservations/update @@ -61,9 +61,8 @@ FLAGS --share-with=SHARE_WITH,[SHARE_WITH,...] If this reservation is shared (--share-setting is not local), provide a - list of all of the specific projects or folders that this reservation - is shared with. List must contain project IDs or project numbers or - folder IDs. + list of all of the specific projects that this reservation is shared + with. List must contain project IDs or project numbers. --vm-count=VM_COUNT The number of VM instances that are allocated to this reservation. The diff --git a/gcloud/beta/container/fleet/memberships/get-credentials b/gcloud/beta/container/fleet/memberships/get-credentials index 89c445cef..3b0b87b02 100644 --- a/gcloud/beta/container/fleet/memberships/get-credentials +++ b/gcloud/beta/container/fleet/memberships/get-credentials @@ -58,7 +58,7 @@ POSITIONAL ARGUMENTS --location=LOCATION The location of the membership resource, e.g. us-central1. If not - specified, defaults to global. + specified, attempts to automatically choose the correct region. To set the location attribute: ▸ provide the argument MEMBERSHIP_NAME on the command line with a diff --git a/gcloud/beta/container/hub/memberships/get-credentials b/gcloud/beta/container/hub/memberships/get-credentials index 28a81deb1..991574925 100644 --- a/gcloud/beta/container/hub/memberships/get-credentials +++ b/gcloud/beta/container/hub/memberships/get-credentials @@ -58,7 +58,7 @@ POSITIONAL ARGUMENTS --location=LOCATION The location of the membership resource, e.g. us-central1. If not - specified, defaults to global. + specified, attempts to automatically choose the correct region. To set the location attribute: ▸ provide the argument MEMBERSHIP_NAME on the command line with a diff --git a/gcloud/beta/datastream/connection-profiles/create b/gcloud/beta/datastream/connection-profiles/create index fc3c659e4..f9db3d07f 100644 --- a/gcloud/beta/datastream/connection-profiles/create +++ b/gcloud/beta/datastream/connection-profiles/create @@ -20,7 +20,13 @@ SYNOPSIS --postgresql-port=POSTGRESQL_PORT --postgresql-username=POSTGRESQL_USERNAME (--postgresql-password=POSTGRESQL_PASSWORD - | --postgresql-prompt-for-password)] + | --postgresql-prompt-for-password) + | --sqlserver-database=SQLSERVER_DATABASE + --sqlserver-hostname=SQLSERVER_HOSTNAME + --sqlserver-port=SQLSERVER_PORT + --sqlserver-username=SQLSERVER_USERNAME + (--sqlserver-password=SQLSERVER_PASSWORD + | --sqlserver-prompt-for-password)] [--no-connectivity | --private-connection-name=PRIVATE_CONNECTION_NAME | --static-ip-connectivity | [--forward-ssh-hostname=FORWARD_SSH_HOSTNAME @@ -240,6 +246,40 @@ OPTIONAL FLAGS --postgresql-prompt-for-password Prompt for the password used to connect to the database. + --sqlserver-database=SQLSERVER_DATABASE + Database service for the SQL Server connection. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --sqlserver-hostname=SQLSERVER_HOSTNAME + IP or hostname of the SQL Server source database. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --sqlserver-port=SQLSERVER_PORT + Network port of the SQL Server source database. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --sqlserver-username=SQLSERVER_USERNAME + Username Datastream will use to connect to the database. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + Exactly one of these must be specified: + + --sqlserver-password=SQLSERVER_PASSWORD + Password for the user that Datastream will be using to connect to + the database. This field is not returned on request, and the value + is encrypted when stored in Datastream. + + --sqlserver-prompt-for-password + Prompt for the password used to connect to the database. + At most one of these can be specified: --no-connectivity diff --git a/gcloud/beta/datastream/connection-profiles/discover b/gcloud/beta/datastream/connection-profiles/discover index e0ed562d3..d0f49fecf 100644 --- a/gcloud/beta/datastream/connection-profiles/discover +++ b/gcloud/beta/datastream/connection-profiles/discover @@ -9,7 +9,8 @@ SYNOPSIS [--full-hierarchy | --hierarchy-depth=HIERARCHY_DEPTH] [--mysql-rdbms-file=MYSQL_RDBMS_FILE | --oracle-rdbms-file=ORACLE_RDBMS_FILE - | --postgresql-rdbms-file=POSTGRESQL_RDBMS_FILE] + | --postgresql-rdbms-file=POSTGRESQL_RDBMS_FILE + | --sqlserver-rdbms-file=SQLSERVER_RDBMS_FILE] [--recursive | --recursive-depth=RECURSIVE_DEPTH] [GCLOUD_WIDE_FLAG ...] @@ -109,6 +110,11 @@ OPTIONAL FLAGS enrich with child data objects and metadata. If you pass - as the value of the flag the file content will be read from stdin. + --sqlserver-rdbms-file=SQLSERVER_RDBMS_FILE + Path to a YAML (or JSON) file containing the SQL Server RDBMS to + enrich with child data objects and metadata. If you pass - as the + value of the flag the file content will be read from stdin. + At most one of these can be specified: --recursive diff --git a/gcloud/beta/datastream/connection-profiles/update b/gcloud/beta/datastream/connection-profiles/update index 3355ecac5..9af82ae4a 100644 --- a/gcloud/beta/datastream/connection-profiles/update +++ b/gcloud/beta/datastream/connection-profiles/update @@ -21,7 +21,13 @@ SYNOPSIS --postgresql-port=POSTGRESQL_PORT --postgresql-username=POSTGRESQL_USERNAME --postgresql-password=POSTGRESQL_PASSWORD - | --postgresql-prompt-for-password] + | --postgresql-prompt-for-password + | --sqlserver-database=SQLSERVER_DATABASE + --sqlserver-hostname=SQLSERVER_HOSTNAME + --sqlserver-port=SQLSERVER_PORT + --sqlserver-username=SQLSERVER_USERNAME + --sqlserver-password=SQLSERVER_PASSWORD + | --sqlserver-prompt-for-password] [--clear-labels | --remove-labels=[KEY,...]] [--no-connectivity | --private-connection-name=PRIVATE_CONNECTION_NAME | --static-ip-connectivity @@ -198,6 +204,28 @@ OPTIONAL FLAGS --postgresql-prompt-for-password Prompt for the password used to connect to the database. + --sqlserver-database=SQLSERVER_DATABASE + Database service for the SQL Server connection. + + --sqlserver-hostname=SQLSERVER_HOSTNAME + IP or hostname of the SQL Server source database. + + --sqlserver-port=SQLSERVER_PORT + Network port of the SQL Server source database. + + --sqlserver-username=SQLSERVER_USERNAME + Username Datastream will use to connect to the database. + + At most one of these can be specified: + + --sqlserver-password=SQLSERVER_PASSWORD + Password for the user that Datastream will be using to connect to + the database. This field is not returned on request, and the value + is encrypted when stored in Datastream. + + --sqlserver-prompt-for-password + Prompt for the password used to connect to the database. + At most one of these can be specified: --clear-labels diff --git a/gcloud/beta/datastream/streams/create b/gcloud/beta/datastream/streams/create index 6857a1e21..4a3af27c0 100644 --- a/gcloud/beta/datastream/streams/create +++ b/gcloud/beta/datastream/streams/create @@ -7,13 +7,15 @@ SYNOPSIS (--backfill-none | --backfill-all --mysql-excluded-objects=MYSQL_EXCLUDED_OBJECTS | --oracle-excluded-objects=ORACLE_EXCLUDED_OBJECTS - | --postgresql-excluded-objects=POSTGRESQL_EXCLUDED_OBJECTS) + | --postgresql-excluded-objects=POSTGRESQL_EXCLUDED_OBJECTS + | --sqlserver-excluded-objects=SQLSERVER_EXCLUDED_OBJECTS) (--destination-name=DESTINATION_NAME (--bigquery-destination-config=BIGQUERY_DESTINATION_CONFIG | --gcs-destination-config=GCS_DESTINATION_CONFIG)) (--source-name=SOURCE_NAME (--mysql-source-config=MYSQL_SOURCE_CONFIG | --oracle-source-config=ORACLE_SOURCE_CONFIG - | --postgresql-source-config=POSTGRESQL_SOURCE_CONFIG)) + | --postgresql-source-config=POSTGRESQL_SOURCE_CONFIG + | --sqlserver-source-config=SQLSERVER_SOURCE_CONFIG)) [--labels=[KEY=VALUE,...]] [--force | --validate-only] [GCLOUD_WIDE_FLAG ...] @@ -168,6 +170,31 @@ REQUIRED FLAGS } } + --sqlserver-excluded-objects=SQLSERVER_EXCLUDED_OBJECTS + Path to a YAML (or JSON) file containing the SQL Server data + sources to avoid backfilling. + + The JSON file is formatted as follows, with camelCase field naming: + + { + "schemas": [ + { + "schema": "SAMPLE", + "tables": [ + { + "table": "SAMPLE_TABLE", + "columns": [ + { + "column": "COL", + } + ] + } + ] + } + ] + } + } + This must be specified. Connection profile resource - Resource ID of the destination connection @@ -339,6 +366,36 @@ REQUIRED FLAGS "publication": "SAMPLE_PUBLICATION" } + --sqlserver-source-config=SQLSERVER_SOURCE_CONFIG + Path to a YAML (or JSON) file containing the configuration for SQL + Server Source Config. + + The JSON file is formatted as follows, with camelCase field naming: + + { + "includeObjects": {}, + "excludeObjects": { + "schemas": [ + { + "schema": "SAMPLE", + "tables": [ + { + "table": "SAMPLE_TABLE", + "columns": [ + { + "column": "COL", + } + ] + } + ] + } + ] + }, + "maxConcurrentCdcTasks": 2, + "maxConcurrentBackfillTasks": 10, + "transactionLogs": {} # Or changeTables + } + OPTIONAL FLAGS --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. diff --git a/gcloud/beta/datastream/streams/update b/gcloud/beta/datastream/streams/update index 67a9e8dc1..c1e938bfc 100644 --- a/gcloud/beta/datastream/streams/update +++ b/gcloud/beta/datastream/streams/update @@ -8,7 +8,8 @@ SYNOPSIS [--backfill-none | --backfill-all --mysql-excluded-objects=MYSQL_EXCLUDED_OBJECTS | --oracle-excluded-objects=ORACLE_EXCLUDED_OBJECTS - | --postgresql-excluded-objects=POSTGRESQL_EXCLUDED_OBJECTS] + | --postgresql-excluded-objects=POSTGRESQL_EXCLUDED_OBJECTS + | --sqlserver-excluded-objects=SQLSERVER_EXCLUDED_OBJECTS] [--clear-labels | --remove-labels=[KEY,...]] [--destination-name=DESTINATION_NAME --bigquery-destination-config=BIGQUERY_DESTINATION_CONFIG @@ -16,7 +17,8 @@ SYNOPSIS [--force | --validate-only] [--source-name=SOURCE_NAME --mysql-source-config=MYSQL_SOURCE_CONFIG | --oracle-source-config=ORACLE_SOURCE_CONFIG - | --postgresql-source-config=POSTGRESQL_SOURCE_CONFIG] + | --postgresql-source-config=POSTGRESQL_SOURCE_CONFIG + | --sqlserver-source-config=SQLSERVER_SOURCE_CONFIG] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -189,6 +191,31 @@ FLAGS } } + --sqlserver-excluded-objects=SQLSERVER_EXCLUDED_OBJECTS + Path to a YAML (or JSON) file containing the SQL Server data + sources to avoid backfilling. + + The JSON file is formatted as follows, with camelCase field naming: + + { + "schemas": [ + { + "schema": "SAMPLE", + "tables": [ + { + "table": "SAMPLE_TABLE", + "columns": [ + { + "column": "COL", + } + ] + } + ] + } + ] + } + } + At most one of these can be specified: --clear-labels @@ -379,6 +406,36 @@ FLAGS "publication": "SAMPLE_PUBLICATION" } + --sqlserver-source-config=SQLSERVER_SOURCE_CONFIG + Path to a YAML (or JSON) file containing the configuration for + PostgreSQL Source Config. + + The JSON file is formatted as follows, with camelCase field naming: + + { + "includeObjects": {}, + "excludeObjects": { + "schemas": [ + { + "schema": "SAMPLE", + "tables": [ + { + "table": "SAMPLE_TABLE", + "columns": [ + { + "column": "COL", + } + ] + } + ] + } + ] + }, + "maxConcurrentCdcTasks": 2, + "maxConcurrentBackfillTasks": 10, + "transactionLogs": {} # Or changeTables + } + 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/domains/registrations/help b/gcloud/beta/domains/registrations/help index d9f1165e1..18aa74fa9 100644 --- a/gcloud/beta/domains/registrations/help +++ b/gcloud/beta/domains/registrations/help @@ -38,12 +38,18 @@ COMMANDS (BETA) Get register parameters (including availability) of a specific domain. + initiate-push-transfer + (BETA) Initiates the push transfer process. + list (BETA) List Cloud Domains registrations. register (BETA) Register a new domain. + renew-domain + (BETA) Renew a recently expired Cloud Domains registration. + search-domains (BETA) Search for available domains. diff --git a/gcloud/beta/domains/registrations/initiate-push-transfer b/gcloud/beta/domains/registrations/initiate-push-transfer new file mode 100644 index 000000000..bd0835394 --- /dev/null +++ b/gcloud/beta/domains/registrations/initiate-push-transfer @@ -0,0 +1,76 @@ +NAME + gcloud beta domains registrations initiate-push-transfer - initiates the + push transfer process + +SYNOPSIS + gcloud beta domains registrations initiate-push-transfer REGISTRATION + [--async] [--tag=TAG] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Initiates the Push Transfer process to transfer the domain to + another registrar. The process might complete instantly or might require + confirmation or additional work. Check the emails sent to the email address + of the registrant. The process is aborted after a timeout if it's not + completed. + + This method is only supported for domains that have the + REQUIRE_PUSH_TRANSFER property in the list of domain_properties. The domain + must also be unlocked before it can be transferred to a different + registrar. + +EXAMPLES + To initiate a push transfer for example.co.uk, run: + + $ gcloud beta domains registrations initiate-push-transfer \ + example.co.uk --tag=NEW_REGISTRY_TAG + +POSITIONAL ARGUMENTS + Registration resource - The domain registration to transfer. 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 registration on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument registration on the command line with a fully + specified name; + ◆ location is always global. + + This must be specified. + + REGISTRATION + ID of the registration or fully qualified identifier for the + registration. + + To set the registration attribute: + ▸ provide the argument registration on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --tag=TAG + The Tag of the new registrar. Can be found at + https://nominet.uk/registrar-list/ + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud domains registrations initiate-push-transfer + + $ gcloud alpha domains registrations initiate-push-transfer + diff --git a/gcloud/beta/domains/registrations/register b/gcloud/beta/domains/registrations/register index 9c23a912a..945794c6f 100644 --- a/gcloud/beta/domains/registrations/register +++ b/gcloud/beta/domains/registrations/register @@ -210,10 +210,9 @@ OTHER FLAGS https://support.google.com/domains/answer/7638036 for details. --yearly-price=YEARLY_PRICE - You must accept the yearly price of the domain, either in the - interactive flow or using this flag. The expected format is a number - followed by a currency code, e.g. "12.00 USD". You can get the price - using the get-register-parameters command. + Accept the domain's yearly price in the interactive flow or by using + this flag. Use a number followed by a currency code, for example, + "12.00 USD". Get the price using the get-register-parameters command. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/domains/registrations/renew-domain b/gcloud/beta/domains/registrations/renew-domain new file mode 100644 index 000000000..f53581b4c --- /dev/null +++ b/gcloud/beta/domains/registrations/renew-domain @@ -0,0 +1,81 @@ +NAME + gcloud beta domains registrations renew-domain - renew a recently expired + Cloud Domains registration + +SYNOPSIS + gcloud beta domains registrations renew-domain REGISTRATION + [--validate-only] [--async] [--yearly-price=YEARLY_PRICE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Use this method to renew domains that expired within the last 30 + days. Renewing your domain extends it for one year from the previous + expiration date and you are charged the yearly renewal price. + +EXAMPLES + To renew a registration for example.com interactively, run: + + $ gcloud beta domains registrations renew-domain example.com + + To renew example.com with interactive prompts disabled, provide the + --yearly-price flag. For example, run: + + $ gcloud beta domains registrations renew-domain example.com \ + --yearly-price="12.00 USD" --quiet + +POSITIONAL ARGUMENTS + Registration resource - The domain registration to renew. 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 registration on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument registration on the command line with a fully + specified name; + ◆ location is always global. + + This must be specified. + + REGISTRATION + ID of the registration or fully qualified identifier for the + registration. + + To set the registration attribute: + ▸ provide the argument registration on the command line. + +COMMONLY USED FLAGS + --validate-only + Don't actually renew registration. Only validate arguments. + +OTHER FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --yearly-price=YEARLY_PRICE + Accept the domain's yearly price in the interactive flow or by using + this flag. Use a number followed by a currency code, for example, + "12.00 USD". Get the price by calling the renew-domain command without + the --yearly-price flag. + +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. These + variants are also available: + + $ gcloud domains registrations renew-domain + + $ gcloud alpha domains registrations renew-domain + diff --git a/gcloud/beta/functions/deploy b/gcloud/beta/functions/deploy index 9e289144e..3951e05dd 100644 --- a/gcloud/beta/functions/deploy +++ b/gcloud/beta/functions/deploy @@ -181,9 +181,9 @@ FLAGS For a list of available runtimes, run gcloud functions runtimes list. --runtime-update-policy=RUNTIME_UPDATE_POLICY - Runtime update policy for the 1st gen function being deployed. The - option on-deploy is used by default. RUNTIME_UPDATE_POLICY must be one - of: automatic, on-deploy. + Runtime update policy for the function being deployed. The option + automatic is used by default. RUNTIME_UPDATE_POLICY must be one of: + automatic, on-deploy. --security-level=SECURITY_LEVEL; default="secure-always" Security level controls whether a function's URL supports HTTPS only or diff --git a/gcloud/beta/healthcare/fhir-stores/create b/gcloud/beta/healthcare/fhir-stores/create index b0f1f3ac1..af71d87af 100644 --- a/gcloud/beta/healthcare/fhir-stores/create +++ b/gcloud/beta/healthcare/fhir-stores/create @@ -6,8 +6,9 @@ SYNOPSIS gcloud beta healthcare fhir-stores create (FHIR_STORE : --dataset=DATASET --location=LOCATION) [--disable-referential-integrity] [--disable-resource-versioning] - [--enable-update-create] [--pubsub-topic=PUBSUB_TOPIC] - [--version=VERSION] [GCLOUD_WIDE_FLAG ...] + [--enable-history-modifications] [--enable-update-create] + [--pubsub-topic=PUBSUB_TOPIC] [--version=VERSION] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Creates a Cloud Healthcare API FHIR store. @@ -81,6 +82,15 @@ FLAGS can be fetched through the history APIs, but cannot be updated. This field is immutable after store creation. + --enable-history-modifications + Whether this FHIR store has history modifications enabled. Enabling + history modifications is required to use FHIR history bundles with the + executeBundle + (https://cloud.google.com/healthcare-api/docs/reference/rest/v1beta1/projects.locations.datasets.fhirStores.fhir/executeBundle) + and importHistory + (https://cloud.google.com/healthcare-api/docs/reference/rest/v1beta1/projects.locations.datasets.fhirStores/importHistory) + APIs. + --enable-update-create Whether this FHIR store has the [updateCreate] (https://www.hl7.org/fhir/capabilitystatement-definitions.html#CapabilityStatement.rest.resource.updateCreate) diff --git a/gcloud/beta/healthcare/fhir-stores/update b/gcloud/beta/healthcare/fhir-stores/update index 23a736f61..27ca61bb1 100644 --- a/gcloud/beta/healthcare/fhir-stores/update +++ b/gcloud/beta/healthcare/fhir-stores/update @@ -5,8 +5,8 @@ NAME SYNOPSIS gcloud beta healthcare fhir-stores update (FHIR_STORE : --dataset=DATASET --location=LOCATION) - [--enable-update-create] [--pubsub-topic=PUBSUB_TOPIC] - [GCLOUD_WIDE_FLAG ...] + [--enable-history-modifications] [--enable-update-create] + [--pubsub-topic=PUBSUB_TOPIC] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Update a Cloud Healthcare API FHIR store. @@ -58,6 +58,15 @@ POSITIONAL ARGUMENTS ▸ set the property healthcare/location. FLAGS + --enable-history-modifications + Whether this FHIR store has history modifications enabled. Enabling + history modifications is required to use FHIR history bundles with the + executeBundle + (https://cloud.google.com/healthcare-api/docs/reference/rest/v1beta1/projects.locations.datasets.fhirStores.fhir/executeBundle) + and importHistory + (https://cloud.google.com/healthcare-api/docs/reference/rest/v1beta1/projects.locations.datasets.fhirStores/importHistory) + APIs. + --enable-update-create Whether this FHIR store has the [updateCreate] (https://www.hl7.org/fhir/capabilitystatement-definitions.html#CapabilityStatement.rest.resource.updateCreate) diff --git a/gcloud/beta/pubsub/subscriptions/create b/gcloud/beta/pubsub/subscriptions/create index 0f289a359..ec5cc54b1 100644 --- a/gcloud/beta/pubsub/subscriptions/create +++ b/gcloud/beta/pubsub/subscriptions/create @@ -13,9 +13,10 @@ SYNOPSIS [--push-auth-token-audience=OPTIONAL_AUDIENCE_OVERRIDE] [--push-endpoint=PUSH_ENDPOINT] [--retain-acked-messages] [[--bigquery-table=BIGQUERY_TABLE - : --drop-unknown-fields --write-metadata --use-table-schema + : --bigquery-service-account-email=BIGQUERY_SERVICE_ACCOUNT_EMAIL + --drop-unknown-fields --write-metadata --use-table-schema | --use-topic-schema] | [--cloud-storage-bucket=CLOUD_STORAGE_BUCKET - : --cloud-storage-file-datetime-format=CLOUD_STORAGE_FILE_DATETIME_FORMAT --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX --cloud-storage-max-bytes=CLOUD_STORAGE_MAX_BYTES --cloud-storage-max-duration=CLOUD_STORAGE_MAX_DURATION --cloud-storage-output-format=OUTPUT_FORMAT; default="text" --cloud-storage-write-metadata]] + : --cloud-storage-file-datetime-format=CLOUD_STORAGE_FILE_DATETIME_FORMAT --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX --cloud-storage-max-bytes=CLOUD_STORAGE_MAX_BYTES --cloud-storage-max-duration=CLOUD_STORAGE_MAX_DURATION --cloud-storage-output-format=OUTPUT_FORMAT; default="text" --cloud-storage-service-account-email=CLOUD_STORAGE_SERVICE_ACCOUNT_EMAIL --cloud-storage-write-metadata]] [--max-delivery-attempts=MAX_DELIVERY_ATTEMPTS [--dead-letter-topic=DEAD_LETTER_TOPIC : --dead-letter-topic-project=DEAD_LETTER_TOPIC_PROJECT]] @@ -160,6 +161,11 @@ OPTIONAL FLAGS This flag argument must be specified if any of the other arguments in this group are specified. + --bigquery-service-account-email=BIGQUERY_SERVICE_ACCOUNT_EMAIL + The service account email to use when writing to BigQuery. If + unspecified, uses the Pub/Sub service agent + (https://cloud.google.com/iam/docs/service-account-types#service-agents). + --drop-unknown-fields If either --use-topic-schema or --use-table-schema is set, whether or not to ignore fields in the message that do not appear in the @@ -231,6 +237,11 @@ OPTIONAL FLAGS avro (messages will be written as an Avro binary). OUTPUT_FORMAT must be one of: text, avro. + --cloud-storage-service-account-email=CLOUD_STORAGE_SERVICE_ACCOUNT_EMAIL + The service account email to use when writing to Cloud Storage. If + unspecified, uses the Pub/Sub service agent + (https://cloud.google.com/iam/docs/service-account-types#service-agents). + --cloud-storage-write-metadata Whether or not to write the subscription name, message_id, publish_time, attributes, and ordering_key as additional fields in diff --git a/gcloud/beta/pubsub/subscriptions/update b/gcloud/beta/pubsub/subscriptions/update index 4ba0c5f68..1f137adea 100644 --- a/gcloud/beta/pubsub/subscriptions/update +++ b/gcloud/beta/pubsub/subscriptions/update @@ -12,10 +12,11 @@ SYNOPSIS [--push-endpoint=PUSH_ENDPOINT] [--retain-acked-messages] [--update-labels=[KEY=VALUE,...]] [--clear-bigquery-config | [--bigquery-table=BIGQUERY_TABLE - : --drop-unknown-fields --write-metadata --use-table-schema + : --bigquery-service-account-email=BIGQUERY_SERVICE_ACCOUNT_EMAIL + --drop-unknown-fields --write-metadata --use-table-schema | --use-topic-schema] | --clear-cloud-storage-config | [--cloud-storage-bucket=CLOUD_STORAGE_BUCKET - : --cloud-storage-file-datetime-format=CLOUD_STORAGE_FILE_DATETIME_FORMAT --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX --cloud-storage-max-bytes=CLOUD_STORAGE_MAX_BYTES --cloud-storage-max-duration=CLOUD_STORAGE_MAX_DURATION --cloud-storage-output-format=OUTPUT_FORMAT; default="text" --cloud-storage-write-metadata]] + : --cloud-storage-file-datetime-format=CLOUD_STORAGE_FILE_DATETIME_FORMAT --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX --cloud-storage-max-bytes=CLOUD_STORAGE_MAX_BYTES --cloud-storage-max-duration=CLOUD_STORAGE_MAX_DURATION --cloud-storage-output-format=OUTPUT_FORMAT; default="text" --cloud-storage-service-account-email=CLOUD_STORAGE_SERVICE_ACCOUNT_EMAIL --cloud-storage-write-metadata]] [--clear-dead-letter-policy | --max-delivery-attempts=MAX_DELIVERY_ATTEMPTS [--dead-letter-topic=DEAD_LETTER_TOPIC @@ -130,6 +131,11 @@ FLAGS This flag argument must be specified if any of the other arguments in this group are specified. + --bigquery-service-account-email=BIGQUERY_SERVICE_ACCOUNT_EMAIL + The service account email to use when writing to BigQuery. If + unspecified, uses the Pub/Sub service agent + (https://cloud.google.com/iam/docs/service-account-types#service-agents). + --drop-unknown-fields If either --use-topic-schema or --use-table-schema is set, whether or not to ignore fields in the message that do not appear @@ -211,6 +217,11 @@ FLAGS avro (messages will be written as an Avro binary). OUTPUT_FORMAT must be one of: text, avro. + --cloud-storage-service-account-email=CLOUD_STORAGE_SERVICE_ACCOUNT_EMAIL + The service account email to use when writing to Cloud Storage. + If unspecified, uses the Pub/Sub service agent + (https://cloud.google.com/iam/docs/service-account-types#service-agents). + --cloud-storage-write-metadata Whether or not to write the subscription name, message_id, publish_time, attributes, and ordering_key as additional fields diff --git a/gcloud/beta/spanner/databases/change-quorum b/gcloud/beta/spanner/databases/change-quorum new file mode 100644 index 000000000..48993c6aa --- /dev/null +++ b/gcloud/beta/spanner/databases/change-quorum @@ -0,0 +1,105 @@ +NAME + gcloud beta spanner databases change-quorum - change quorum of a Cloud + Spanner database + +SYNOPSIS + gcloud beta spanner databases change-quorum + (DATABASE : --instance=INSTANCE) + (--dual-region | --serving-location=SERVING_LOCATION --single-region) + [--etag=ETAG] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Change quorum of a Cloud Spanner database. + +EXAMPLES + To trigger change quorum from single-region mode to dual-region mode, run: + + $ gcloud beta spanner databases change-quorum my-database-id \ + --instance=my-instance-id --dual-region + + To trigger change quorum from dual-region mode to single-region mode with + serving location as asia-south1, run: + + $ gcloud beta spanner databases change-quorum my-database-id \ + --instance=my-instance-id --single-region \ + --serving-location=asia-south1 + + To trigger change quorum using etag specified, run: + + $ gcloud beta spanner databases change-quorum my-database-id \ + --instance=my-instance-id --dual-region --etag=ETAG + +POSITIONAL ARGUMENTS + Database resource - The Cloud Spanner database to change quorum. 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 database 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. + + DATABASE + ID of the database or fully qualified identifier for the database. + + To set the database attribute: + ▸ provide the argument database on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --instance=INSTANCE + The Cloud Spanner instance for the database. + + To set the instance attribute: + ▸ provide the argument database on the command line with a fully + specified name; + ▸ provide the argument --instance on the command line; + ▸ set the property spanner/instance. + +REQUIRED FLAGS + Exactly one of these must be specified: + + Command-line flag for dual-region quorum change: + + --dual-region + Switch to dual-region quorum type. + + Command-line flags for single-region quorum change: + + --serving-location=SERVING_LOCATION + The cloud Spanner location. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --single-region + Switch to single-region quorum type. + + This flag argument must be specified if any of the other arguments + in this group are specified. + +OPTIONAL FLAGS + --etag=ETAG + Used for optimistic concurrency control. + +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. These + variants are also available: + + $ gcloud spanner databases change-quorum + + $ gcloud alpha spanner databases change-quorum + diff --git a/gcloud/beta/spanner/databases/create b/gcloud/beta/spanner/databases/create index 252d83e8e..ad535ba18 100644 --- a/gcloud/beta/spanner/databases/create +++ b/gcloud/beta/spanner/databases/create @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud beta spanner databases create (DATABASE : --instance=INSTANCE) [--async] [--database-dialect=DATABASE_DIALECT] [--ddl=DDL] - [--ddl-file=DDL_FILE] + [--ddl-file=DDL_FILE] [--proto-descriptors-file=PROTO_DESCRIPTORS_FILE] [--kms-key=KMS_KEY : --kms-keyring=KMS_KEYRING --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT] [GCLOUD_WIDE_FLAG ...] @@ -87,6 +87,11 @@ FLAGS --ddl_file is set, --ddl is ignored. One line comments starting with -- are ignored. + --proto-descriptors-file=PROTO_DESCRIPTORS_FILE + Path of a file that contains a protobuf-serialized + google.protobuf.FileDescriptorSet message. To generate it, install and + run protoc with --include_imports and --descriptor_set_out. + KMS key name group At most one of these can be specified: diff --git a/gcloud/beta/spanner/databases/ddl/describe b/gcloud/beta/spanner/databases/ddl/describe index 6b655e71a..eaf0015b6 100644 --- a/gcloud/beta/spanner/databases/ddl/describe +++ b/gcloud/beta/spanner/databases/ddl/describe @@ -4,8 +4,9 @@ NAME SYNOPSIS gcloud beta spanner databases ddl describe (DATABASE : --instance=INSTANCE) - [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] - [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + [--include-proto-descriptors] [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Describe the DDL for a Cloud Spanner database. @@ -48,6 +49,11 @@ POSITIONAL ARGUMENTS ▸ provide the argument --instance on the command line; ▸ set the property spanner/instance. +FLAGS + --include-proto-descriptors + Include debug string of proto bundle descriptors in the output. The + output is information only and not meant to be parsed. + LIST COMMAND FLAGS --filter=EXPRESSION Apply a Boolean filter EXPRESSION to each resource item to be listed. diff --git a/gcloud/beta/spanner/databases/ddl/update b/gcloud/beta/spanner/databases/ddl/update index e0427bb86..ce39cd47a 100644 --- a/gcloud/beta/spanner/databases/ddl/update +++ b/gcloud/beta/spanner/databases/ddl/update @@ -4,7 +4,9 @@ NAME SYNOPSIS gcloud beta spanner databases ddl update (DATABASE : --instance=INSTANCE) - [--async] [--ddl=DDL] [--ddl-file=DDL_FILE] [GCLOUD_WIDE_FLAG ...] + [--async] [--ddl=DDL] [--ddl-file=DDL_FILE] + [--proto-descriptors-file=PROTO_DESCRIPTORS_FILE] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Update the DDL for a Cloud Spanner database. @@ -65,6 +67,11 @@ FLAGS --ddl_file is set, --ddl is ignored. One line comments starting with -- are ignored. + --proto-descriptors-file=PROTO_DESCRIPTORS_FILE + Path of a file that contains a protobuf-serialized + google.protobuf.FileDescriptorSet message. To generate it, install and + run protoc with --include_imports and --descriptor_set_out. + 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/spanner/databases/help b/gcloud/beta/spanner/databases/help index dcc19894d..a7c373cad 100644 --- a/gcloud/beta/spanner/databases/help +++ b/gcloud/beta/spanner/databases/help @@ -30,6 +30,9 @@ COMMANDS add-iam-policy-binding (BETA) Add IAM policy binding to a Cloud Spanner database. + change-quorum + (BETA) Change quorum of a Cloud Spanner database. + create (BETA) Create a Cloud Spanner database. diff --git a/gcloud/beta/spanner/operations/cancel b/gcloud/beta/spanner/operations/cancel index f6cfc226d..dcd2ab9f8 100644 --- a/gcloud/beta/spanner/operations/cancel +++ b/gcloud/beta/spanner/operations/cancel @@ -25,6 +25,12 @@ EXAMPLES $ gcloud beta spanner operations cancel _auto_12345 \ --instance=my-instance-id --backup=my-backup-id + To cancel a Cloud Spanner instance partition operation with ID auto_12345, + run: + + $ gcloud beta spanner operations cancel auto_12345 \ + --instance=my-instance-id --instance-partition=my-partition-id + POSITIONAL ARGUMENTS OPERATION-ID ID of the operation diff --git a/gcloud/beta/spanner/operations/describe b/gcloud/beta/spanner/operations/describe index 208bb4e45..32753c33a 100644 --- a/gcloud/beta/spanner/operations/describe +++ b/gcloud/beta/spanner/operations/describe @@ -26,6 +26,11 @@ EXAMPLES $ gcloud beta spanner operations describe _auto_12345 \ --instance=my-instance-id --backup=my-backup-id + To describe a Cloud Spanner instance partition operation, run: + + $ gcloud beta spanner operations describe _auto_12345 \ + --instance=my-instance-id --instance-partition=my-partition-id + POSITIONAL ARGUMENTS OPERATION-ID ID of the operation diff --git a/gcloud/beta/spanner/operations/list b/gcloud/beta/spanner/operations/list index 2ed6b9ae0..80d448f7d 100644 --- a/gcloud/beta/spanner/operations/list +++ b/gcloud/beta/spanner/operations/list @@ -42,6 +42,17 @@ EXAMPLES $ gcloud beta spanner operations list --instance=my-instance-id \ --backup=my-backup-id --type=BACKUP + To list Cloud Spanner instance partition operations for an instance + partition, run: + + $ gcloud beta spanner operations list --instance=my-instance-id \ + --instance-partition=my-partition-id --type=INSTANCE_PARTITION + + To list Cloud Spanner instance partition operations for an instance, run: + + $ gcloud beta spanner operations list --instance=my-instance-id \ + --type=INSTANCE_PARTITION + REQUIRED FLAGS Exactly one of these must be specified: @@ -95,6 +106,12 @@ FLAGS INSTANCE_CONFIG_UPDATE Instance configuration update operations are returned for the given instance configuration (--instance-config). + INSTANCE_PARTITION + If only the instance is specified (--instance), returns all + instance partition operations associated with instance partitions + in the instance. When an instance partition is specified + (--instance-partition), only the instance partition operations for + the given instance partition are returned. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/beta/workstations/configs/create b/gcloud/beta/workstations/configs/create index 892d7b53c..0bd517027 100644 --- a/gcloud/beta/workstations/configs/create +++ b/gcloud/beta/workstations/configs/create @@ -4,7 +4,8 @@ NAME SYNOPSIS gcloud beta workstations configs create - (CONFIG : --cluster=CLUSTER --region=REGION) [--async] + (CONFIG : --cluster=CLUSTER --region=REGION) + [--allowed-ports=[ALLOWED_PORTS,...]] [--async] [--boost-config=[BOOST_CONFIG,...]] [--boot-disk-size=BOOT_DISK_SIZE; default=50] [--container-args=[CONTAINER_ARGS,...]] @@ -101,6 +102,39 @@ POSITIONAL ARGUMENTS ▸ set the property workstations/region. FLAGS + --allowed-ports=[ALLOWED_PORTS,...] + A Single or Range of ports externally accessible in the workstation. If + not specified defaults to ports 22, 80 and ports 1024-65535. + + To specify a single port, both first and last should be same. + + Example: + + $ gcloud beta workstations configs create \ + --allowed-ports=first=9000,last=9090 + $ gcloud beta workstations configs create \ + --allowed-ports=first=80,last=80 + + Sets allowed_ports value. + + first + Required, Sets first value. + + last + Required, Sets last value. + + Shorthand Example: + + --allowed-ports=first=int,last=int + + JSON Example: + + --allowed-ports='{"first": int, "last": int}' + + File Example: + + --allowed-ports=path_to_file.(yaml|json) + --async Return immediately, without waiting for the operation in progress to complete. @@ -108,7 +142,8 @@ FLAGS --boost-config=[BOOST_CONFIG,...] Boost Configuration(s) that workstations running with this configuration can boost up to. This includes id (required), - machine-type, accelerator-type, and accelerator-count. + machine-type, accelerator-type, accelerator-count, pool-size, + boot-disk-size, and enable-nested-virtualization. Example: @@ -124,19 +159,28 @@ FLAGS accelerator-type Sets accelerator-type value. + boot-disk-size + Sets boot-disk-size value. + + enable-nested-virtualization + Sets enable-nested-virtualization value. + id Required, Sets id value. machine-type Sets machine-type value. + pool-size + Sets pool-size value. + Shorthand Example: - --boost-config=accelerator-count=int,accelerator-type=string,id=string,machine-type=string + --boost-config=accelerator-count=int,accelerator-type=string,boot-disk-size=int,enable-nested-virtualization=boolean,id=string,machine-type=string,pool-size=int JSON Example: - --boost-config='{"accelerator-count": int, "accelerator-type": "string", "id": "string", "machine-type": "string"}' + --boost-config='{"accelerator-count": int, "accelerator-type": "string", "boot-disk-size": int, "enable-nested-virtualization": boolean, "id": "string", "machine-type": "string", "pool-size": int}' File Example: diff --git a/gcloud/beta/workstations/configs/update b/gcloud/beta/workstations/configs/update index bf3a8f609..d5c8ed62a 100644 --- a/gcloud/beta/workstations/configs/update +++ b/gcloud/beta/workstations/configs/update @@ -4,7 +4,8 @@ NAME SYNOPSIS gcloud beta workstations configs update - (CONFIG : --cluster=CLUSTER --region=REGION) [--async] + (CONFIG : --cluster=CLUSTER --region=REGION) + [--allowed-ports=[ALLOWED_PORTS,...]] [--async] [--boost-config=[BOOST_CONFIG,...]] [--boot-disk-size=BOOT_DISK_SIZE] [--container-args=[CONTAINER_ARGS,...]] [--container-command=[CONTAINER_COMMAND,...]] @@ -88,6 +89,39 @@ POSITIONAL ARGUMENTS ▸ set the property workstations/region. FLAGS + --allowed-ports=[ALLOWED_PORTS,...] + A Single or Range of ports externally accessible in the workstation. If + not specified defaults to ports 22, 80 and ports 1024-65535. + + To specify a single port, both first and last should be same. + + Example: + + $ gcloud beta workstations configs update \ + --allowed-ports=first=9000,last=9090 + $ gcloud beta workstations configs update \ + --allowed-ports=first=80,last=80 + + Sets allowed_ports value. + + first + Required, Sets first value. + + last + Required, Sets last value. + + Shorthand Example: + + --allowed-ports=first=int,last=int + + JSON Example: + + --allowed-ports='{"first": int, "last": int}' + + File Example: + + --allowed-ports=path_to_file.(yaml|json) + --async Return immediately, without waiting for the operation in progress to complete. @@ -95,7 +129,8 @@ FLAGS --boost-config=[BOOST_CONFIG,...] Boost Configuration(s) that workstations running with this configuration can boost up to. This includes id (required), - machine-type, accelerator-type, and accelerator-count. + machine-type, accelerator-type, accelerator-count, pool-size, + boot-disk-size, and enable-nested-virtualization. Example: @@ -111,19 +146,28 @@ FLAGS accelerator-type Sets accelerator-type value. + boot-disk-size + Sets boot-disk-size value. + + enable-nested-virtualization + Sets enable-nested-virtualization value. + id Required, Sets id value. machine-type Sets machine-type value. + pool-size + Sets pool-size value. + Shorthand Example: - --boost-config=accelerator-count=int,accelerator-type=string,id=string,machine-type=string + --boost-config=accelerator-count=int,accelerator-type=string,boot-disk-size=int,enable-nested-virtualization=boolean,id=string,machine-type=string,pool-size=int JSON Example: - --boost-config='{"accelerator-count": int, "accelerator-type": "string", "id": "string", "machine-type": "string"}' + --boost-config='{"accelerator-count": int, "accelerator-type": "string", "boot-disk-size": int, "enable-nested-virtualization": boolean, "id": "string", "machine-type": "string", "pool-size": int}' File Example: diff --git a/gcloud/compute/backend-services/create b/gcloud/compute/backend-services/create index 87f3ac27a..3c3269ed5 100644 --- a/gcloud/compute/backend-services/create +++ b/gcloud/compute/backend-services/create @@ -495,17 +495,26 @@ FLAGS If the load-balancing-scheme is INTERNAL_MANAGED (Internal Application Load Balancer), the protocol must be one of: HTTP, HTTPS, HTTP2. + If the load-balancing-scheme is INTERNAL_MANAGED (Internal proxy + Network Load Balancer), the protocol must be only TCP. + If the load-balancing-scheme is EXTERNAL and region is not set (Classic - Application Load Balancer and global external proxy Network Load - Balancer), the protocol must be one of: HTTP, HTTPS, HTTP2, SSL, TCP. + Application Load Balancer and Classic proxy Network Load Balancer), the + protocol must be one of: HTTP, HTTPS, HTTP2, TCP, SSL. If the load-balancing-scheme is EXTERNAL and region is set (External passthrough Network Load Balancer), the protocol must be one of: TCP, UDP, UNSPECIFIED. - If the load-balancing-scheme is EXTERNAL_MANAGED (Envoy based Global - and regional external Application Load Balancers), the protocol must be - one of: HTTP, HTTPS, HTTP2. + If the load-balancing-scheme is EXTERNAL_MANAGED (Global external + Application Load Balancer and regional external Application Load + Balancer), the protocol must be one of: HTTP, HTTPS, HTTP2. + + If the load-balancing-scheme is EXTERNAL_MANAGED (Global external proxy + Network Load Balancer), the protocol must be one of: TCP, SSL. + + If the load-balancing-scheme is EXTERNAL_MANAGED (Regional external + proxy Network Load Balancer), the protocol must be only TCP. --[no-]request-coalescing Enables request coalescing to the backend (recommended). diff --git a/gcloud/compute/backend-services/update b/gcloud/compute/backend-services/update index dcdfe16bf..1b17824d1 100644 --- a/gcloud/compute/backend-services/update +++ b/gcloud/compute/backend-services/update @@ -319,17 +319,26 @@ FLAGS If the load-balancing-scheme is INTERNAL_MANAGED (Internal Application Load Balancer), the protocol must be one of: HTTP, HTTPS, HTTP2. + If the load-balancing-scheme is INTERNAL_MANAGED (Internal proxy + Network Load Balancer), the protocol must be only TCP. + If the load-balancing-scheme is EXTERNAL and region is not set (Classic - Application Load Balancer and global external proxy Network Load - Balancer), the protocol must be one of: HTTP, HTTPS, HTTP2, SSL, TCP. + Application Load Balancer and Classic proxy Network Load Balancer), the + protocol must be one of: HTTP, HTTPS, HTTP2, TCP, SSL. If the load-balancing-scheme is EXTERNAL and region is set (External passthrough Network Load Balancer), the protocol must be one of: TCP, UDP, UNSPECIFIED. - If the load-balancing-scheme is EXTERNAL_MANAGED (Envoy based Global - and regional external Application Load Balancers), the protocol must be - one of: HTTP, HTTPS, HTTP2. + If the load-balancing-scheme is EXTERNAL_MANAGED (Global external + Application Load Balancer and regional external Application Load + Balancer), the protocol must be one of: HTTP, HTTPS, HTTP2. + + If the load-balancing-scheme is EXTERNAL_MANAGED (Global external proxy + Network Load Balancer), the protocol must be one of: TCP, SSL. + + If the load-balancing-scheme is EXTERNAL_MANAGED (Regional external + proxy Network Load Balancer), the protocol must be only TCP. --[no-]request-coalescing Enables request coalescing to the backend (recommended). diff --git a/gcloud/compute/commitments/create b/gcloud/compute/commitments/create index 88a2fe71e..ee40f3e8a 100644 --- a/gcloud/compute/commitments/create +++ b/gcloud/compute/commitments/create @@ -212,14 +212,13 @@ OPTIONAL FLAGS --share-setting=SHARE_SETTING Specify if this reservation is shared, and if so, the type of sharing. If you omit this flag, this value is local (not shared) - by default. SHARE_SETTING must be one of: local, projects, - folders. + by default. SHARE_SETTING must be one of: local, projects. --share-with=SHARE_WITH,[SHARE_WITH,...] If this reservation is shared (--share-setting is not local), - provide a list of all of the specific projects or folders that - this reservation is shared with. List must contain project IDs or - project numbers or folder IDs. + provide a list of all of the specific projects that this + reservation is shared with. List must contain project IDs or + project numbers. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/compute/disks/create b/gcloud/compute/disks/create index 15550248f..99c54db16 100644 --- a/gcloud/compute/disks/create +++ b/gcloud/compute/disks/create @@ -3,8 +3,9 @@ NAME SYNOPSIS gcloud compute disks create DISK_NAME [DISK_NAME ...] - [--architecture=ARCHITECTURE] [--confidential-compute] - [--csek-key-file=FILE] [--description=DESCRIPTION] + [--access-mode=ACCESS_MODE] [--architecture=ARCHITECTURE] + [--confidential-compute] [--csek-key-file=FILE] + [--description=DESCRIPTION] [--guest-os-features=[GUEST_OS_FEATURE,...]] [--labels=[KEY=VALUE,...]] [--licenses=[LICENSE,...]] [--primary-disk-project=PRIMARY_DISK_PROJECT] @@ -58,6 +59,14 @@ POSITIONAL ARGUMENTS https://cloud.google.com/compute/docs/naming-resources FLAGS + --access-mode=ACCESS_MODE + Specifie how VMs attached to the disk can access the data on the disk. + To grant read-only access to multiple VMs attached to the disk, set + access-mode to READ_ONLY_MANY. To grant read-write access to only one + VM attached to the disk, use READ_WRITE_SINGLE. READ_WRITE_SINGLE is + used if omitted. ACCESS_MODE must be one of: READ_ONLY_MANY, + READ_WRITE_MANY, READ_WRITE_SINGLE. + --architecture=ARCHITECTURE Specifies the architecture or processor type that this disk can support. For available processor types on Compute Engine, see diff --git a/gcloud/compute/disks/update b/gcloud/compute/disks/update index 8a1377447..5cc1b5b5b 100644 --- a/gcloud/compute/disks/update +++ b/gcloud/compute/disks/update @@ -2,7 +2,8 @@ NAME gcloud compute disks update - update a Compute Engine persistent disk SYNOPSIS - gcloud compute disks update DISK_NAME [--provisioned-iops=PROVISIONED_IOPS] + gcloud compute disks update DISK_NAME [--access-mode=ACCESS_MODE] + [--provisioned-iops=PROVISIONED_IOPS] [--provisioned-throughput=PROVISIONED_THROUGHPUT] [--size=SIZE] [--update-labels=[KEY=VALUE,...]] [--clear-architecture | --update-architecture=UPDATE_ARCHITECTURE] @@ -36,6 +37,14 @@ POSITIONAL ARGUMENTS Name of the disk to update. FLAGS + --access-mode=ACCESS_MODE + Specifie how VMs attached to the disk can access the data on the disk. + To grant read-only access to multiple VMs attached to the disk, set + access-mode to READ_ONLY_MANY. To grant read-write access to only one + VM attached to the disk, use READ_WRITE_SINGLE. READ_WRITE_SINGLE is + used if omitted. ACCESS_MODE must be one of: READ_ONLY_MANY, + READ_WRITE_MANY, READ_WRITE_SINGLE. + --provisioned-iops=PROVISIONED_IOPS Provisioned IOPS of disk to update. Only for use with disks of type hyperdisk-extreme. diff --git a/gcloud/compute/images/import b/gcloud/compute/images/import index 1cd8f8430..892b3bec8 100644 --- a/gcloud/compute/images/import +++ b/gcloud/compute/images/import @@ -23,6 +23,9 @@ DESCRIPTION gcloud compute images import imports Virtual Disk images, such as VMWare VMDK files and VHD files, into Compute Engine. + NOTE: It is recommended to use the new Image Import. Run "gcloud alpha + migration vms image-imports --help" for details. + Importing images involves four steps: ▪ Upload the virtual disk file to Cloud Storage. ▪ Import the image to Compute Engine. @@ -47,6 +50,15 @@ DESCRIPTION See https://cloud.google.com/compute/docs/images/importing-virtual-disks#resource_cleanup. + Troubleshooting: Image import/export tools rely on CloudBuild default + behavior. They has been using the default CloudBuild service account in + order to import/export images to/from Google Cloud Platform. However, Cloud + Build has changed this default behavior and in new projects a custom user + managed service account may need to be provided to perform the builds. If + you get a CloudBuild service account related error, run gcloud with + --cloudbuild-service-account=. See gcloud compute + images import --help for details. + EXAMPLES To import a centos-7 VMDK file, run: diff --git a/gcloud/compute/reservations/create b/gcloud/compute/reservations/create index a5de031cd..a22d8e88a 100644 --- a/gcloud/compute/reservations/create +++ b/gcloud/compute/reservations/create @@ -140,13 +140,12 @@ OPTIONAL FLAGS --share-setting=SHARE_SETTING Specify if this reservation is shared, and if so, the type of sharing. If you omit this flag, this value is local (not shared) by - default. SHARE_SETTING must be one of: local, projects, folders. + default. SHARE_SETTING must be one of: local, projects. --share-with=SHARE_WITH,[SHARE_WITH,...] If this reservation is shared (--share-setting is not local), provide - a list of all of the specific projects or folders that this - reservation is shared with. List must contain project IDs or project - numbers or folder IDs. + a list of all of the specific projects that this reservation is + shared with. List must contain project IDs or project numbers. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/compute/target-https-proxies/create b/gcloud/compute/target-https-proxies/create index dd40a46b4..8fdc71611 100644 --- a/gcloud/compute/target-https-proxies/create +++ b/gcloud/compute/target-https-proxies/create @@ -6,7 +6,7 @@ SYNOPSIS [--certificate-map=CERTIFICATE_MAP] [--description=DESCRIPTION] [--http-keep-alive-timeout-sec=HTTP_KEEP_ALIVE_TIMEOUT_SEC] [--quic-override=QUIC_OVERRIDE; default="NONE"] - [--ssl-policy=SSL_POLICY] + [--ssl-policy=SSL_POLICY] [--tls-early-data=TLS_EARLY_DATA] [--certificate-manager-certificates=[CERTIFICATE_MANAGER_CERTIFICATES, ...] | --ssl-certificates=SSL_CERTIFICATE,[...]] [--global | --region=REGION] @@ -103,6 +103,29 @@ OPTIONAL FLAGS and load balancers that are using the HTTPS proxy. The SSL policy must exist and cannot be deleted while referenced by a target HTTPS proxy. + --tls-early-data=TLS_EARLY_DATA + TLS 1.3 Early Data ("0-RTT" or "zero round trip") allows clients to + include HTTP request data alongside a TLS handshake. This can improve + application performance, especially on networks where connection + interruptions may be common, such as on mobile. This applies to both + HTTP over TCP (ie: HTTP/1.1 and HTTP/2) and HTTP/3 over QUIC. + TLS_EARLY_DATA must be one of: + + DISABLED + TLS 1.3 Early Data is not advertised, and any (invalid) attempts to + send Early Data will be rejected. + PERMISSIVE + Enables TLS 1.3 Early Data for requests with safe HTTP methods + (GET, HEAD, OPTIONS, TRACE). This mode does not enforce any other + limitations for requests with Early Data. The application owner + should validate that Early Data is acceptable for a given request + path. + STRICT + Enables TLS 1.3 Early Data for requests with safe HTTP methods, and + HTTP requests that do not have query parameters. Requests that send + Early Data containing non-idempotent HTTP methods or with query + parameters will be rejected with a HTTP 425. + At most one of these can be specified: Certificate resource - certificate-manager-certificates to attach. This diff --git a/gcloud/compute/target-https-proxies/update b/gcloud/compute/target-https-proxies/update index eacf466d3..3d2a423a9 100644 --- a/gcloud/compute/target-https-proxies/update +++ b/gcloud/compute/target-https-proxies/update @@ -3,7 +3,8 @@ NAME SYNOPSIS gcloud compute target-https-proxies update NAME - [--quic-override=QUIC_OVERRIDE] [--url-map=URL_MAP] + [--quic-override=QUIC_OVERRIDE] [--tls-early-data=TLS_EARLY_DATA] + [--url-map=URL_MAP] [--certificate-manager-certificates=[CERTIFICATE_MANAGER_CERTIFICATES, ...] | --clear-ssl-certificates | --ssl-certificates=SSL_CERTIFICATE,[...] --global-ssl-certificates @@ -66,6 +67,29 @@ FLAGS NONE Allows Google to control when QUIC is rolled out. + --tls-early-data=TLS_EARLY_DATA + TLS 1.3 Early Data ("0-RTT" or "zero round trip") allows clients to + include HTTP request data alongside a TLS handshake. This can improve + application performance, especially on networks where connection + interruptions may be common, such as on mobile. This applies to both + HTTP over TCP (ie: HTTP/1.1 and HTTP/2) and HTTP/3 over QUIC. + TLS_EARLY_DATA must be one of: + + DISABLED + TLS 1.3 Early Data is not advertised, and any (invalid) attempts to + send Early Data will be rejected. + PERMISSIVE + Enables TLS 1.3 Early Data for requests with safe HTTP methods + (GET, HEAD, OPTIONS, TRACE). This mode does not enforce any other + limitations for requests with Early Data. The application owner + should validate that Early Data is acceptable for a given request + path. + STRICT + Enables TLS 1.3 Early Data for requests with safe HTTP methods, and + HTTP requests that do not have query parameters. Requests that send + Early Data containing non-idempotent HTTP methods or with query + parameters will be rejected with a HTTP 425. + --url-map=URL_MAP A reference to a URL map resource. A URL map defines the mapping of URLs to backend services. Before you can refer to a URL map, you must diff --git a/gcloud/container/fleet/memberships/get-credentials b/gcloud/container/fleet/memberships/get-credentials index 6a0b2588e..3b836ba61 100644 --- a/gcloud/container/fleet/memberships/get-credentials +++ b/gcloud/container/fleet/memberships/get-credentials @@ -58,7 +58,7 @@ POSITIONAL ARGUMENTS --location=LOCATION The location of the membership resource, e.g. us-central1. If not - specified, defaults to global. + specified, attempts to automatically choose the correct region. To set the location attribute: ▸ provide the argument MEMBERSHIP_NAME on the command line with a diff --git a/gcloud/container/hub/memberships/get-credentials b/gcloud/container/hub/memberships/get-credentials index c2b1a0028..c9049db92 100644 --- a/gcloud/container/hub/memberships/get-credentials +++ b/gcloud/container/hub/memberships/get-credentials @@ -58,7 +58,7 @@ POSITIONAL ARGUMENTS --location=LOCATION The location of the membership resource, e.g. us-central1. If not - specified, defaults to global. + specified, attempts to automatically choose the correct region. To set the location attribute: ▸ provide the argument MEMBERSHIP_NAME on the command line with a diff --git a/gcloud/dataplex/entries/help b/gcloud/dataplex/entries/help index 2fdf709a9..bfe1cb1e4 100644 --- a/gcloud/dataplex/entries/help +++ b/gcloud/dataplex/entries/help @@ -33,6 +33,9 @@ COMMANDS remove-aspects Remove aspects from a Dataplex Entry. + search + Searches for Dataplex entries. + update Update a Dataplex Entry. diff --git a/gcloud/dataplex/entries/search b/gcloud/dataplex/entries/search new file mode 100644 index 000000000..36cf7a345 --- /dev/null +++ b/gcloud/dataplex/entries/search @@ -0,0 +1,60 @@ +NAME + gcloud dataplex entries search - searches for Dataplex entries + +SYNOPSIS + gcloud dataplex entries search QUERY --project=PROJECT [--limit=LIMIT] + [--order-by=ORDER_BY] [--page-size=PAGE_SIZE] [--scope=SCOPE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Searches for entries matching given query and scope. + +EXAMPLES + To search project 'my-project' for Dataplex resources that match the simple + predicate 'foo': + + $ gcloud dataplex entries search 'foo' --project=my-project + +POSITIONAL ARGUMENTS + QUERY + The query against which entries in scope should be matched. + +REQUIRED FLAGS + --project=PROJECT + The project to which the request should be attributed. + +OPTIONAL FLAGS + --limit=LIMIT + Maximum number of resources. + + --order-by=ORDER_BY + Specifies the ordering of results, currently supported case-sensitive + choices are: + + ◆ title [asc|desc], defaults to ascending if not specified. + + --page-size=PAGE_SIZE + Maximum number of resources per page. No more than 1000. + + --scope=SCOPE + The scope under which the search should be operating. Should either be + organizations/ or projects/. If left unspecified, + it will default to the organization where the project is located. + +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 dataplex/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/dataplex/docs + +NOTES + This variant is also available: + + $ gcloud alpha dataplex entries search + diff --git a/gcloud/datastream/connection-profiles/create b/gcloud/datastream/connection-profiles/create index c71a21c23..9991ea4ce 100644 --- a/gcloud/datastream/connection-profiles/create +++ b/gcloud/datastream/connection-profiles/create @@ -20,7 +20,13 @@ SYNOPSIS --postgresql-port=POSTGRESQL_PORT --postgresql-username=POSTGRESQL_USERNAME (--postgresql-password=POSTGRESQL_PASSWORD - | --postgresql-prompt-for-password)] + | --postgresql-prompt-for-password) + | --sqlserver-database=SQLSERVER_DATABASE + --sqlserver-hostname=SQLSERVER_HOSTNAME + --sqlserver-port=SQLSERVER_PORT + --sqlserver-username=SQLSERVER_USERNAME + (--sqlserver-password=SQLSERVER_PASSWORD + | --sqlserver-prompt-for-password)] [--private-connection=PRIVATE_CONNECTION | --static-ip-connectivity | [--forward-ssh-hostname=FORWARD_SSH_HOSTNAME --forward-ssh-username=FORWARD_SSH_USERNAME @@ -252,6 +258,40 @@ OPTIONAL FLAGS --postgresql-prompt-for-password Prompt for the password used to connect to the database. + --sqlserver-database=SQLSERVER_DATABASE + Database service for the SQL Server connection. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --sqlserver-hostname=SQLSERVER_HOSTNAME + IP or hostname of the SQL Server source database. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --sqlserver-port=SQLSERVER_PORT + Network port of the SQL Server source database. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --sqlserver-username=SQLSERVER_USERNAME + Username Datastream will use to connect to the database. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + Exactly one of these must be specified: + + --sqlserver-password=SQLSERVER_PASSWORD + Password for the user that Datastream will be using to connect to + the database. This field is not returned on request, and the value + is encrypted when stored in Datastream. + + --sqlserver-prompt-for-password + Prompt for the password used to connect to the database. + At most one of these can be specified: Private connection resource - Resource ID of the private connection. diff --git a/gcloud/datastream/connection-profiles/discover b/gcloud/datastream/connection-profiles/discover index 924ac363b..8e3410c02 100644 --- a/gcloud/datastream/connection-profiles/discover +++ b/gcloud/datastream/connection-profiles/discover @@ -9,7 +9,8 @@ SYNOPSIS [--full-hierarchy | --hierarchy-depth=HIERARCHY_DEPTH] [--mysql-rdbms-file=MYSQL_RDBMS_FILE | --oracle-rdbms-file=ORACLE_RDBMS_FILE - | --postgresql-rdbms-file=POSTGRESQL_RDBMS_FILE] + | --postgresql-rdbms-file=POSTGRESQL_RDBMS_FILE + | --sqlserver-rdbms-file=SQLSERVER_RDBMS_FILE] [--recursive | --recursive-depth=RECURSIVE_DEPTH] [GCLOUD_WIDE_FLAG ...] @@ -106,6 +107,11 @@ OPTIONAL FLAGS enrich with child data objects and metadata. If you pass - as the value of the flag the file content will be read from stdin. + --sqlserver-rdbms-file=SQLSERVER_RDBMS_FILE + Path to a YAML (or JSON) file containing the SQL Server RDBMS to + enrich with child data objects and metadata. If you pass - as the + value of the flag the file content will be read from stdin. + At most one of these can be specified: --recursive diff --git a/gcloud/datastream/connection-profiles/update b/gcloud/datastream/connection-profiles/update index cedca45d7..ff45aac68 100644 --- a/gcloud/datastream/connection-profiles/update +++ b/gcloud/datastream/connection-profiles/update @@ -22,7 +22,13 @@ SYNOPSIS --postgresql-port=POSTGRESQL_PORT --postgresql-username=POSTGRESQL_USERNAME --postgresql-password=POSTGRESQL_PASSWORD - | --postgresql-prompt-for-password] + | --postgresql-prompt-for-password + | --sqlserver-database=SQLSERVER_DATABASE + --sqlserver-hostname=SQLSERVER_HOSTNAME + --sqlserver-port=SQLSERVER_PORT + --sqlserver-username=SQLSERVER_USERNAME + --sqlserver-password=SQLSERVER_PASSWORD + | --sqlserver-prompt-for-password] [--clear-labels | --remove-labels=[KEY,...]] [--private-connection=PRIVATE_CONNECTION | --static-ip-connectivity | --forward-ssh-hostname=FORWARD_SSH_HOSTNAME @@ -211,6 +217,28 @@ OPTIONAL FLAGS --postgresql-prompt-for-password Prompt for the password used to connect to the database. + --sqlserver-database=SQLSERVER_DATABASE + Database service for the SQL Server connection. + + --sqlserver-hostname=SQLSERVER_HOSTNAME + IP or hostname of the SQL Server source database. + + --sqlserver-port=SQLSERVER_PORT + Network port of the SQL Server source database. + + --sqlserver-username=SQLSERVER_USERNAME + Username Datastream will use to connect to the database. + + At most one of these can be specified: + + --sqlserver-password=SQLSERVER_PASSWORD + Password for the user that Datastream will be using to connect to + the database. This field is not returned on request, and the value + is encrypted when stored in Datastream. + + --sqlserver-prompt-for-password + Prompt for the password used to connect to the database. + At most one of these can be specified: --clear-labels diff --git a/gcloud/datastream/objects/lookup b/gcloud/datastream/objects/lookup index 79697bf9d..8f2623a11 100644 --- a/gcloud/datastream/objects/lookup +++ b/gcloud/datastream/objects/lookup @@ -6,7 +6,9 @@ SYNOPSIS (--mysql-database=MYSQL_DATABASE --mysql-table=MYSQL_TABLE | --oracle-schema=ORACLE_SCHEMA --oracle-table=ORACLE_TABLE | --postgresql-schema=POSTGRESQL_SCHEMA - --postgresql-table=POSTGRESQL_TABLE) + --postgresql-table=POSTGRESQL_TABLE + | --sqlserver-schema=SQLSERVER_SCHEMA + --sqlserver-table=SQLSERVER_TABLE) (--stream=STREAM : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -70,6 +72,18 @@ REQUIRED FLAGS This flag argument must be specified if any of the other arguments in this group are specified. + --sqlserver-schema=SQLSERVER_SCHEMA + SQL Server schema for the object. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --sqlserver-table=SQLSERVER_TABLE + SQL Server table for the object. + + This flag argument must be specified if any of the other arguments in + this group are specified. + Stream resource - The stream to list objects 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 diff --git a/gcloud/datastream/streams/create b/gcloud/datastream/streams/create index 6cd76d03c..f153b5a54 100644 --- a/gcloud/datastream/streams/create +++ b/gcloud/datastream/streams/create @@ -7,13 +7,15 @@ SYNOPSIS (--backfill-none | --backfill-all --mysql-excluded-objects=MYSQL_EXCLUDED_OBJECTS | --oracle-excluded-objects=ORACLE_EXCLUDED_OBJECTS - | --postgresql-excluded-objects=POSTGRESQL_EXCLUDED_OBJECTS) + | --postgresql-excluded-objects=POSTGRESQL_EXCLUDED_OBJECTS + | --sqlserver-excluded-objects=SQLSERVER_EXCLUDED_OBJECTS) (--destination=DESTINATION (--bigquery-destination-config=BIGQUERY_DESTINATION_CONFIG | --gcs-destination-config=GCS_DESTINATION_CONFIG)) (--source=SOURCE (--mysql-source-config=MYSQL_SOURCE_CONFIG | --oracle-source-config=ORACLE_SOURCE_CONFIG - | --postgresql-source-config=POSTGRESQL_SOURCE_CONFIG)) + | --postgresql-source-config=POSTGRESQL_SOURCE_CONFIG + | --sqlserver-source-config=SQLSERVER_SOURCE_CONFIG)) [--labels=[KEY=VALUE,...]] [--force | --validate-only] [GCLOUD_WIDE_FLAG ...] @@ -183,6 +185,31 @@ REQUIRED FLAGS } } + --sqlserver-excluded-objects=SQLSERVER_EXCLUDED_OBJECTS + Path to a YAML (or JSON) file containing the SQL Server data + sources to avoid backfilling. + + The JSON file is formatted as follows, with camelCase field naming: + + { + "schemas": [ + { + "schema": "SAMPLE", + "tables": [ + { + "table": "SAMPLE_TABLE", + "columns": [ + { + "column": "COL", + } + ] + } + ] + } + ] + } + } + This must be specified. Connection profile resource - Resource ID of the destination connection @@ -352,6 +379,36 @@ REQUIRED FLAGS "publication": "SAMPLE_PUBLICATION" } + --sqlserver-source-config=SQLSERVER_SOURCE_CONFIG + Path to a YAML (or JSON) file containing the configuration for SQL + Server Source Config. + + The JSON file is formatted as follows, with camelCase field naming: + + { + "includeObjects": {}, + "excludeObjects": { + "schemas": [ + { + "schema": "SAMPLE", + "tables": [ + { + "table": "SAMPLE_TABLE", + "columns": [ + { + "column": "COL", + } + ] + } + ] + } + ] + }, + "maxConcurrentCdcTasks": 2, + "maxConcurrentBackfillTasks": 10, + "transactionLogs": {} # Or changeTables + } + OPTIONAL FLAGS --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. diff --git a/gcloud/datastream/streams/update b/gcloud/datastream/streams/update index 80a55c126..90da72831 100644 --- a/gcloud/datastream/streams/update +++ b/gcloud/datastream/streams/update @@ -8,7 +8,8 @@ SYNOPSIS [--backfill-none | --backfill-all --mysql-excluded-objects=MYSQL_EXCLUDED_OBJECTS | --oracle-excluded-objects=ORACLE_EXCLUDED_OBJECTS - | --postgresql-excluded-objects=POSTGRESQL_EXCLUDED_OBJECTS] + | --postgresql-excluded-objects=POSTGRESQL_EXCLUDED_OBJECTS + | --sqlserver-excluded-objects=SQLSERVER_EXCLUDED_OBJECTS] [--clear-labels | --remove-labels=[KEY,...]] [--destination=DESTINATION --bigquery-destination-config=BIGQUERY_DESTINATION_CONFIG @@ -16,7 +17,8 @@ SYNOPSIS [--force | --validate-only] [--source=SOURCE --mysql-source-config=MYSQL_SOURCE_CONFIG | --oracle-source-config=ORACLE_SOURCE_CONFIG - | --postgresql-source-config=POSTGRESQL_SOURCE_CONFIG] + | --postgresql-source-config=POSTGRESQL_SOURCE_CONFIG + | --sqlserver-source-config=SQLSERVER_SOURCE_CONFIG] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -185,6 +187,31 @@ FLAGS } } + --sqlserver-excluded-objects=SQLSERVER_EXCLUDED_OBJECTS + Path to a YAML (or JSON) file containing the SQL Server data + sources to avoid backfilling. + + The JSON file is formatted as follows, with camelCase field naming: + + { + "schemas": [ + { + "schema": "SAMPLE", + "tables": [ + { + "table": "SAMPLE_TABLE", + "columns": [ + { + "column": "COL", + } + ] + } + ] + } + ] + } + } + At most one of these can be specified: --clear-labels @@ -375,6 +402,36 @@ FLAGS "publication": "SAMPLE_PUBLICATION" } + --sqlserver-source-config=SQLSERVER_SOURCE_CONFIG + Path to a YAML (or JSON) file containing the configuration for + PostgreSQL Source Config. + + The JSON file is formatted as follows, with camelCase field naming: + + { + "includeObjects": {}, + "excludeObjects": { + "schemas": [ + { + "schema": "SAMPLE", + "tables": [ + { + "table": "SAMPLE_TABLE", + "columns": [ + { + "column": "COL", + } + ] + } + ] + } + ] + }, + "maxConcurrentCdcTasks": 2, + "maxConcurrentBackfillTasks": 10, + "transactionLogs": {} # Or changeTables + } + 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/domains/registrations/help b/gcloud/domains/registrations/help index 25b05b15d..fd8555fa1 100644 --- a/gcloud/domains/registrations/help +++ b/gcloud/domains/registrations/help @@ -37,12 +37,18 @@ COMMANDS get-register-parameters Get register parameters (including availability) of a specific domain. + initiate-push-transfer + Initiates the push transfer process. + list List Cloud Domains registrations. register Register a new domain. + renew-domain + Renew a recently expired Cloud Domains registration. + search-domains Search for available domains. diff --git a/gcloud/domains/registrations/initiate-push-transfer b/gcloud/domains/registrations/initiate-push-transfer new file mode 100644 index 000000000..d3def94ab --- /dev/null +++ b/gcloud/domains/registrations/initiate-push-transfer @@ -0,0 +1,75 @@ +NAME + gcloud domains registrations initiate-push-transfer - initiates the push + transfer process + +SYNOPSIS + gcloud domains registrations initiate-push-transfer REGISTRATION [--async] + [--tag=TAG] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Initiates the Push Transfer process to transfer the domain to another + registrar. The process might complete instantly or might require + confirmation or additional work. Check the emails sent to the email address + of the registrant. The process is aborted after a timeout if it's not + completed. + + This method is only supported for domains that have the + REQUIRE_PUSH_TRANSFER property in the list of domain_properties. The domain + must also be unlocked before it can be transferred to a different + registrar. + +EXAMPLES + To initiate a push transfer for example.co.uk, run: + + $ gcloud domains registrations initiate-push-transfer \ + example.co.uk --tag=NEW_REGISTRY_TAG + +POSITIONAL ARGUMENTS + Registration resource - The domain registration to transfer. 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 registration on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument registration on the command line with a fully + specified name; + ◆ location is always global. + + This must be specified. + + REGISTRATION + ID of the registration or fully qualified identifier for the + registration. + + To set the registration attribute: + ▸ provide the argument registration on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --tag=TAG + The Tag of the new registrar. Can be found at + https://nominet.uk/registrar-list/ + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha domains registrations initiate-push-transfer + + $ gcloud beta domains registrations initiate-push-transfer + diff --git a/gcloud/domains/registrations/register b/gcloud/domains/registrations/register index 1d7a319a5..266d810c0 100644 --- a/gcloud/domains/registrations/register +++ b/gcloud/domains/registrations/register @@ -210,10 +210,9 @@ OTHER FLAGS https://support.google.com/domains/answer/7638036 for details. --yearly-price=YEARLY_PRICE - You must accept the yearly price of the domain, either in the - interactive flow or using this flag. The expected format is a number - followed by a currency code, e.g. "12.00 USD". You can get the price - using the get-register-parameters command. + Accept the domain's yearly price in the interactive flow or by using + this flag. Use a number followed by a currency code, for example, + "12.00 USD". Get the price using the get-register-parameters command. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/domains/registrations/renew-domain b/gcloud/domains/registrations/renew-domain new file mode 100644 index 000000000..e2bc59b46 --- /dev/null +++ b/gcloud/domains/registrations/renew-domain @@ -0,0 +1,79 @@ +NAME + gcloud domains registrations renew-domain - renew a recently expired Cloud + Domains registration + +SYNOPSIS + gcloud domains registrations renew-domain REGISTRATION [--validate-only] + [--async] [--yearly-price=YEARLY_PRICE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Use this method to renew domains that expired within the last 30 days. + Renewing your domain extends it for one year from the previous expiration + date and you are charged the yearly renewal price. + +EXAMPLES + To renew a registration for example.com interactively, run: + + $ gcloud domains registrations renew-domain example.com + + To renew example.com with interactive prompts disabled, provide the + --yearly-price flag. For example, run: + + $ gcloud domains registrations renew-domain example.com \ + --yearly-price="12.00 USD" --quiet + +POSITIONAL ARGUMENTS + Registration resource - The domain registration to renew. 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 registration on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument registration on the command line with a fully + specified name; + ◆ location is always global. + + This must be specified. + + REGISTRATION + ID of the registration or fully qualified identifier for the + registration. + + To set the registration attribute: + ▸ provide the argument registration on the command line. + +COMMONLY USED FLAGS + --validate-only + Don't actually renew registration. Only validate arguments. + +OTHER FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --yearly-price=YEARLY_PRICE + Accept the domain's yearly price in the interactive flow or by using + this flag. Use a number followed by a currency code, for example, + "12.00 USD". Get the price by calling the renew-domain command without + the --yearly-price flag. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha domains registrations renew-domain + + $ gcloud beta domains registrations renew-domain + diff --git a/gcloud/functions/deploy b/gcloud/functions/deploy index 28c356764..8101310c4 100644 --- a/gcloud/functions/deploy +++ b/gcloud/functions/deploy @@ -171,9 +171,9 @@ FLAGS For a list of available runtimes, run gcloud functions runtimes list. --runtime-update-policy=RUNTIME_UPDATE_POLICY - Runtime update policy for the 1st gen function being deployed. The - option on-deploy is used by default. RUNTIME_UPDATE_POLICY must be one - of: automatic, on-deploy. + Runtime update policy for the function being deployed. The option + automatic is used by default. RUNTIME_UPDATE_POLICY must be one of: + automatic, on-deploy. --security-level=SECURITY_LEVEL; default="secure-always" Security level controls whether a function's URL supports HTTPS only or diff --git a/gcloud/pubsub/subscriptions/create b/gcloud/pubsub/subscriptions/create index 55a14171a..3a3a489ad 100644 --- a/gcloud/pubsub/subscriptions/create +++ b/gcloud/pubsub/subscriptions/create @@ -13,9 +13,10 @@ SYNOPSIS [--push-auth-token-audience=OPTIONAL_AUDIENCE_OVERRIDE] [--push-endpoint=PUSH_ENDPOINT] [--retain-acked-messages] [[--bigquery-table=BIGQUERY_TABLE - : --drop-unknown-fields --write-metadata --use-table-schema + : --bigquery-service-account-email=BIGQUERY_SERVICE_ACCOUNT_EMAIL + --drop-unknown-fields --write-metadata --use-table-schema | --use-topic-schema] | [--cloud-storage-bucket=CLOUD_STORAGE_BUCKET - : --cloud-storage-file-datetime-format=CLOUD_STORAGE_FILE_DATETIME_FORMAT --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX --cloud-storage-max-bytes=CLOUD_STORAGE_MAX_BYTES --cloud-storage-max-duration=CLOUD_STORAGE_MAX_DURATION --cloud-storage-output-format=OUTPUT_FORMAT; default="text" --cloud-storage-write-metadata]] + : --cloud-storage-file-datetime-format=CLOUD_STORAGE_FILE_DATETIME_FORMAT --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX --cloud-storage-max-bytes=CLOUD_STORAGE_MAX_BYTES --cloud-storage-max-duration=CLOUD_STORAGE_MAX_DURATION --cloud-storage-output-format=OUTPUT_FORMAT; default="text" --cloud-storage-service-account-email=CLOUD_STORAGE_SERVICE_ACCOUNT_EMAIL --cloud-storage-write-metadata]] [--max-delivery-attempts=MAX_DELIVERY_ATTEMPTS [--dead-letter-topic=DEAD_LETTER_TOPIC : --dead-letter-topic-project=DEAD_LETTER_TOPIC_PROJECT]] @@ -160,6 +161,11 @@ OPTIONAL FLAGS This flag argument must be specified if any of the other arguments in this group are specified. + --bigquery-service-account-email=BIGQUERY_SERVICE_ACCOUNT_EMAIL + The service account email to use when writing to BigQuery. If + unspecified, uses the Pub/Sub service agent + (https://cloud.google.com/iam/docs/service-account-types#service-agents). + --drop-unknown-fields If either --use-topic-schema or --use-table-schema is set, whether or not to ignore fields in the message that do not appear in the @@ -231,6 +237,11 @@ OPTIONAL FLAGS avro (messages will be written as an Avro binary). OUTPUT_FORMAT must be one of: text, avro. + --cloud-storage-service-account-email=CLOUD_STORAGE_SERVICE_ACCOUNT_EMAIL + The service account email to use when writing to Cloud Storage. If + unspecified, uses the Pub/Sub service agent + (https://cloud.google.com/iam/docs/service-account-types#service-agents). + --cloud-storage-write-metadata Whether or not to write the subscription name, message_id, publish_time, attributes, and ordering_key as additional fields in diff --git a/gcloud/pubsub/subscriptions/update b/gcloud/pubsub/subscriptions/update index e40ed81a1..e169980ea 100644 --- a/gcloud/pubsub/subscriptions/update +++ b/gcloud/pubsub/subscriptions/update @@ -12,10 +12,11 @@ SYNOPSIS [--push-endpoint=PUSH_ENDPOINT] [--retain-acked-messages] [--update-labels=[KEY=VALUE,...]] [--clear-bigquery-config | [--bigquery-table=BIGQUERY_TABLE - : --drop-unknown-fields --write-metadata --use-table-schema + : --bigquery-service-account-email=BIGQUERY_SERVICE_ACCOUNT_EMAIL + --drop-unknown-fields --write-metadata --use-table-schema | --use-topic-schema] | --clear-cloud-storage-config | [--cloud-storage-bucket=CLOUD_STORAGE_BUCKET - : --cloud-storage-file-datetime-format=CLOUD_STORAGE_FILE_DATETIME_FORMAT --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX --cloud-storage-max-bytes=CLOUD_STORAGE_MAX_BYTES --cloud-storage-max-duration=CLOUD_STORAGE_MAX_DURATION --cloud-storage-output-format=OUTPUT_FORMAT; default="text" --cloud-storage-write-metadata]] + : --cloud-storage-file-datetime-format=CLOUD_STORAGE_FILE_DATETIME_FORMAT --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX --cloud-storage-max-bytes=CLOUD_STORAGE_MAX_BYTES --cloud-storage-max-duration=CLOUD_STORAGE_MAX_DURATION --cloud-storage-output-format=OUTPUT_FORMAT; default="text" --cloud-storage-service-account-email=CLOUD_STORAGE_SERVICE_ACCOUNT_EMAIL --cloud-storage-write-metadata]] [--clear-dead-letter-policy | --max-delivery-attempts=MAX_DELIVERY_ATTEMPTS [--dead-letter-topic=DEAD_LETTER_TOPIC @@ -130,6 +131,11 @@ FLAGS This flag argument must be specified if any of the other arguments in this group are specified. + --bigquery-service-account-email=BIGQUERY_SERVICE_ACCOUNT_EMAIL + The service account email to use when writing to BigQuery. If + unspecified, uses the Pub/Sub service agent + (https://cloud.google.com/iam/docs/service-account-types#service-agents). + --drop-unknown-fields If either --use-topic-schema or --use-table-schema is set, whether or not to ignore fields in the message that do not appear @@ -211,6 +217,11 @@ FLAGS avro (messages will be written as an Avro binary). OUTPUT_FORMAT must be one of: text, avro. + --cloud-storage-service-account-email=CLOUD_STORAGE_SERVICE_ACCOUNT_EMAIL + The service account email to use when writing to Cloud Storage. + If unspecified, uses the Pub/Sub service agent + (https://cloud.google.com/iam/docs/service-account-types#service-agents). + --cloud-storage-write-metadata Whether or not to write the subscription name, message_id, publish_time, attributes, and ordering_key as additional fields diff --git a/gcloud/redis/clusters/create b/gcloud/redis/clusters/create index 8caafc3d2..89e39f773 100644 --- a/gcloud/redis/clusters/create +++ b/gcloud/redis/clusters/create @@ -10,7 +10,8 @@ SYNOPSIS [--rdb-snapshot-period=RDB_SNAPSHOT_PERIOD] [--rdb-snapshot-start-time=RDB_SNAPSHOT_START_TIME] [--redis-config=[KEY=VALUE,...]] [--replica-count=REPLICA_COUNT] - [--transit-encryption-mode=TRANSIT_ENCRYPTION_MODE] + [--transit-encryption-mode=TRANSIT_ENCRYPTION_MODE] [--zone=ZONE] + [--zone-distribution-mode=ZONE_DISTRIBUTION_MODE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -173,6 +174,20 @@ OPTIONAL FLAGS The cluster uses server managed encryption for in-transit encryption. + --zone=ZONE + The zone used to allocate the cluster nodes. Applicable only if the + zone-distribution-mode is set to single-zone. + + --zone-distribution-mode=ZONE_DISTRIBUTION_MODE + Determines how the cluster nodes are distributed across zones. + ZONE_DISTRIBUTION_MODE must be one of: + + multi-zone + Allocate cluster nodes across multiple zones. + + single-zone + Allocate cluster nodes in a single zone. + 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/secrets/create b/gcloud/secrets/create index 5ef33a961..a93b1693e 100644 --- a/gcloud/secrets/create +++ b/gcloud/secrets/create @@ -4,6 +4,7 @@ NAME SYNOPSIS gcloud secrets create SECRET [--data-file=PATH] [--labels=[KEY=VALUE,...]] [--set-annotations=[KEY=VALUE,...]] [--topics=[TOPICS,...]] + [--version-destroy-ttl=VERSION-DESTROY-TTL] [--expire-time=EXPIRE-TIME | --ttl=TTL] [--next-rotation-time=NEXT_ROTATION_TIME --rotation-period=ROTATION_PERIOD] @@ -61,6 +62,10 @@ EXAMPLES --next-rotation-time="2030-01-01T15:30:00-05:00" \ --rotation-period="7200s" + Create a secret with delayed secret version destroy enabled: + + $ gcloud secrets create my-secret --version-destroy-ttl="86400s" + POSITIONAL ARGUMENTS Secret resource - The secret to create. This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this group but can be @@ -102,6 +107,13 @@ FLAGS --topics=[TOPICS,...] List of Pub/Sub topics to configure on the secret. + --version-destroy-ttl=VERSION-DESTROY-TTL + Secret Version Time To Live (TTL) after destruction request. For secret + with TTL>0, version destruction does not happen immediately on calling + destroy; instead, the version goes to a disabled state and destruction + happens after the TTL expires. See $ gcloud topic datetimes for + information on duration formats. + Expiration. At most one of these can be specified: diff --git a/gcloud/secrets/update b/gcloud/secrets/update index a1d2d8392..551cbfc14 100644 --- a/gcloud/secrets/update +++ b/gcloud/secrets/update @@ -15,7 +15,8 @@ SYNOPSIS [--next-rotation-time=NEXT_ROTATION_TIME --remove-next-rotation-time --remove-rotation-period --remove-rotation-schedule --rotation-period=ROTATION_PERIOD] - [GCLOUD_WIDE_FLAG ...] + [--remove-version-destroy-ttl + | --version-destroy-ttl=VERSION-DESTROY-TTL] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Update a secret's metadata (e.g. labels). This command will return an error @@ -50,6 +51,14 @@ EXAMPLES $ gcloud secrets update my-secret --remove-rotation-schedule + Update version destroy ttl of a secret: + + $ gcloud secrets update my-secret --version-destroy-ttl="86400s" + + Disable delayed secret version destroy: + + $ gcloud secrets update my-secret --remove-version-destroy-ttl + POSITIONAL ARGUMENTS Secret resource - The secret to update. This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this group but can be @@ -175,6 +184,20 @@ FLAGS --rotation-period=ROTATION_PERIOD Duration of time (in seconds) between rotation notifications. + Version destroy ttl. + + At most one of these can be specified: + + --remove-version-destroy-ttl + If set, removes the version destroy TTL from the secret. + + --version-destroy-ttl=VERSION-DESTROY-TTL + Secret Version TTL after destruction request. For secret with TTL>0, + version destruction does not happen immediately on calling destroy; + instead, the version goes to a disabled state and destruction happens + after the TTL expires. See $ gcloud topic datetimes for information + on duration formats. + 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/spanner/databases/change-quorum b/gcloud/spanner/databases/change-quorum new file mode 100644 index 000000000..884263b91 --- /dev/null +++ b/gcloud/spanner/databases/change-quorum @@ -0,0 +1,103 @@ +NAME + gcloud spanner databases change-quorum - change quorum of a Cloud Spanner + database + +SYNOPSIS + gcloud spanner databases change-quorum (DATABASE : --instance=INSTANCE) + (--dual-region | --serving-location=SERVING_LOCATION --single-region) + [--etag=ETAG] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Change quorum of a Cloud Spanner database. + +EXAMPLES + To trigger change quorum from single-region mode to dual-region mode, run: + + $ gcloud spanner databases change-quorum my-database-id \ + --instance=my-instance-id --dual-region + + To trigger change quorum from dual-region mode to single-region mode with + serving location as asia-south1, run: + + $ gcloud spanner databases change-quorum my-database-id \ + --instance=my-instance-id --single-region \ + --serving-location=asia-south1 + + To trigger change quorum using etag specified, run: + + $ gcloud spanner databases change-quorum my-database-id \ + --instance=my-instance-id --dual-region --etag=ETAG + +POSITIONAL ARGUMENTS + Database resource - The Cloud Spanner database to change quorum. 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 database 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. + + DATABASE + ID of the database or fully qualified identifier for the database. + + To set the database attribute: + ▸ provide the argument database on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --instance=INSTANCE + The Cloud Spanner instance for the database. + + To set the instance attribute: + ▸ provide the argument database on the command line with a fully + specified name; + ▸ provide the argument --instance on the command line; + ▸ set the property spanner/instance. + +REQUIRED FLAGS + Exactly one of these must be specified: + + Command-line flag for dual-region quorum change: + + --dual-region + Switch to dual-region quorum type. + + Command-line flags for single-region quorum change: + + --serving-location=SERVING_LOCATION + The cloud Spanner location. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --single-region + Switch to single-region quorum type. + + This flag argument must be specified if any of the other arguments + in this group are specified. + +OPTIONAL FLAGS + --etag=ETAG + Used for optimistic concurrency control. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha spanner databases change-quorum + + $ gcloud beta spanner databases change-quorum + diff --git a/gcloud/spanner/databases/create b/gcloud/spanner/databases/create index 12892ecca..23914cd34 100644 --- a/gcloud/spanner/databases/create +++ b/gcloud/spanner/databases/create @@ -4,6 +4,7 @@ NAME SYNOPSIS gcloud spanner databases create (DATABASE : --instance=INSTANCE) [--async] [--database-dialect=DATABASE_DIALECT] [--ddl=DDL] [--ddl-file=DDL_FILE] + [--proto-descriptors-file=PROTO_DESCRIPTORS_FILE] [--kms-key=KMS_KEY : --kms-keyring=KMS_KEYRING --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT] [GCLOUD_WIDE_FLAG ...] @@ -84,6 +85,11 @@ FLAGS --ddl_file is set, --ddl is ignored. One line comments starting with -- are ignored. + --proto-descriptors-file=PROTO_DESCRIPTORS_FILE + Path of a file that contains a protobuf-serialized + google.protobuf.FileDescriptorSet message. To generate it, install and + run protoc with --include_imports and --descriptor_set_out. + KMS key name group At most one of these can be specified: diff --git a/gcloud/spanner/databases/ddl/describe b/gcloud/spanner/databases/ddl/describe index f8258a9eb..89f100a1b 100644 --- a/gcloud/spanner/databases/ddl/describe +++ b/gcloud/spanner/databases/ddl/describe @@ -4,8 +4,9 @@ NAME SYNOPSIS gcloud spanner databases ddl describe (DATABASE : --instance=INSTANCE) - [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] - [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + [--include-proto-descriptors] [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Describe the DDL for a Cloud Spanner database. @@ -48,6 +49,11 @@ POSITIONAL ARGUMENTS ▸ provide the argument --instance on the command line; ▸ set the property spanner/instance. +FLAGS + --include-proto-descriptors + Include debug string of proto bundle descriptors in the output. The + output is information only and not meant to be parsed. + LIST COMMAND FLAGS --filter=EXPRESSION Apply a Boolean filter EXPRESSION to each resource item to be listed. diff --git a/gcloud/spanner/databases/ddl/update b/gcloud/spanner/databases/ddl/update index 757b0b558..29d280884 100644 --- a/gcloud/spanner/databases/ddl/update +++ b/gcloud/spanner/databases/ddl/update @@ -4,7 +4,9 @@ NAME SYNOPSIS gcloud spanner databases ddl update (DATABASE : --instance=INSTANCE) - [--async] [--ddl=DDL] [--ddl-file=DDL_FILE] [GCLOUD_WIDE_FLAG ...] + [--async] [--ddl=DDL] [--ddl-file=DDL_FILE] + [--proto-descriptors-file=PROTO_DESCRIPTORS_FILE] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Update the DDL for a Cloud Spanner database. @@ -65,6 +67,11 @@ FLAGS --ddl_file is set, --ddl is ignored. One line comments starting with -- are ignored. + --proto-descriptors-file=PROTO_DESCRIPTORS_FILE + Path of a file that contains a protobuf-serialized + google.protobuf.FileDescriptorSet message. To generate it, install and + run protoc with --include_imports and --descriptor_set_out. + 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/spanner/databases/help b/gcloud/spanner/databases/help index 2dfa362f9..a0496c4d7 100644 --- a/gcloud/spanner/databases/help +++ b/gcloud/spanner/databases/help @@ -30,6 +30,9 @@ COMMANDS add-iam-policy-binding Add IAM policy binding to a Cloud Spanner database. + change-quorum + Change quorum of a Cloud Spanner database. + create Create a Cloud Spanner database.