From f2c5d1d45f8068af91a90b6c9dde721809957199 Mon Sep 17 00:00:00 2001 From: Automated Date: Wed, 1 Nov 2023 10:29:29 +0000 Subject: [PATCH] gcloud: Wed Nov 1 10:29:29 UTC 2023 --- gcloud/_version | 8 +- gcloud/ai/indexes/create | 14 +- gcloud/alpha/ai/indexes/create | 15 +- gcloud/alpha/asset/analyze-iam-policy | 161 +++++++++++ .../asset/analyze-iam-policy-longrunning | 199 ++++++++++++++ gcloud/alpha/asset/help | 7 + .../enterprise-config/bitbucketserver/create | 4 +- .../enterprise-config/bitbucketserver/delete | 4 +- .../enterprise-config/bitbucketserver/help | 10 +- .../enterprise-config/bitbucketserver/update | 4 +- .../builds/enterprise-config/github/create | 4 +- .../builds/enterprise-config/github/delete | 4 +- .../builds/enterprise-config/github/describe | 4 +- .../builds/enterprise-config/github/help | 13 +- .../builds/enterprise-config/github/update | 4 +- .../builds/enterprise-config/gitlab/create | 4 +- .../builds/enterprise-config/gitlab/delete | 4 +- .../builds/enterprise-config/gitlab/help | 12 +- .../builds/enterprise-config/gitlab/update | 4 +- gcloud/alpha/builds/enterprise-config/help | 10 +- gcloud/alpha/builds/help | 6 +- gcloud/alpha/builds/repositories/help | 5 +- gcloud/alpha/builds/submit | 28 +- gcloud/alpha/builds/triggers/config/export | 4 +- gcloud/alpha/builds/triggers/config/help | 2 +- gcloud/alpha/builds/triggers/help | 2 +- gcloud/alpha/builds/triggers/list | 5 +- .../builds/triggers/update/bitbucketserver | 4 +- .../triggers/update/cloud-source-repositories | 5 +- gcloud/alpha/builds/triggers/update/github | 4 +- gcloud/alpha/builds/triggers/update/gitlab | 4 +- gcloud/alpha/builds/triggers/update/help | 15 +- gcloud/alpha/builds/triggers/update/manual | 4 +- gcloud/alpha/builds/triggers/update/pubsub | 4 +- gcloud/alpha/builds/triggers/update/webhook | 4 +- gcloud/alpha/builds/worker-pools/create | 4 +- gcloud/alpha/builds/worker-pools/describe | 5 +- gcloud/alpha/builds/worker-pools/help | 7 +- gcloud/alpha/builds/worker-pools/update | 4 +- gcloud/alpha/compute/snapshots/create | 13 + gcloud/alpha/compute/start-iap-tunnel | 17 +- .../compute/tpus/queued-resources/create | 2 +- gcloud/alpha/compute/tpus/tpu-vm/create | 2 +- gcloud/alpha/config/get | 26 -- gcloud/alpha/config/help | 26 -- gcloud/alpha/config/list | 26 -- gcloud/alpha/config/set | 26 -- gcloud/alpha/config/unset | 26 -- gcloud/alpha/container/aws/clusters/create | 6 +- gcloud/alpha/container/aws/clusters/update | 3 +- gcloud/alpha/container/aws/node-pools/create | 3 +- gcloud/alpha/container/aws/node-pools/update | 3 +- .../container/fleet/identity-service/apply | 65 ++--- .../policycontroller/content/bundles/help | 33 +++ .../policycontroller/content/bundles/remove | 80 ++++++ .../policycontroller/content/bundles/set | 112 ++++++++ .../fleet/policycontroller/content/help | 33 +++ .../content/templates/disable | 76 ++++++ .../policycontroller/content/templates/enable | 77 ++++++ .../policycontroller/content/templates/help | 33 +++ .../fleet/policycontroller/deployment/help | 34 +++ .../fleet/policycontroller/deployment/remove | 138 ++++++++++ .../fleet/policycontroller/deployment/set | 145 ++++++++++ .../container/fleet/policycontroller/describe | 70 +++++ .../container/fleet/policycontroller/detach | 80 ++++++ .../container/fleet/policycontroller/disable | 83 ++++++ .../container/fleet/policycontroller/enable | 181 +++++++++++++ .../container/fleet/policycontroller/help | 34 ++- .../container/fleet/policycontroller/suspend | 79 ++++++ .../container/fleet/policycontroller/update | 164 +++++++++++ .../container/hub/identity-service/apply | 65 ++--- .../hub/policycontroller/content/bundles/help | 33 +++ .../policycontroller/content/bundles/remove | 80 ++++++ .../hub/policycontroller/content/bundles/set | 111 ++++++++ .../hub/policycontroller/content/help | 33 +++ .../content/templates/disable | 76 ++++++ .../policycontroller/content/templates/enable | 76 ++++++ .../policycontroller/content/templates/help | 33 +++ .../hub/policycontroller/deployment/help | 34 +++ .../hub/policycontroller/deployment/remove | 138 ++++++++++ .../hub/policycontroller/deployment/set | 145 ++++++++++ .../container/hub/policycontroller/describe | 70 +++++ .../container/hub/policycontroller/detach | 80 ++++++ .../container/hub/policycontroller/disable | 83 ++++++ .../container/hub/policycontroller/enable | 181 +++++++++++++ .../alpha/container/hub/policycontroller/help | 34 ++- .../container/hub/policycontroller/suspend | 79 ++++++ .../container/hub/policycontroller/update | 164 +++++++++++ gcloud/alpha/dataplex/datascan/create | 159 ----------- gcloud/alpha/dataplex/datascan/delete | 74 ----- gcloud/alpha/dataplex/datascan/describe | 71 ----- gcloud/alpha/dataplex/datascan/help | 47 ---- gcloud/alpha/dataplex/datascan/jobs/describe | 99 ------- gcloud/alpha/dataplex/datascan/jobs/help | 34 --- gcloud/alpha/dataplex/datascan/jobs/list | 104 ------- gcloud/alpha/dataplex/datascan/list | 96 ------- gcloud/alpha/dataplex/datascan/run | 69 ----- gcloud/alpha/dataplex/help | 3 - gcloud/alpha/game/help | 36 --- gcloud/alpha/game/locations/describe | 55 ---- gcloud/alpha/game/locations/help | 33 --- gcloud/alpha/game/locations/list | 70 ----- gcloud/alpha/game/operations/describe | 71 ----- gcloud/alpha/game/operations/help | 34 --- gcloud/alpha/game/operations/list | 91 ------- gcloud/alpha/game/servers/clusters/create | 128 --------- gcloud/alpha/game/servers/clusters/delete | 97 ------- gcloud/alpha/game/servers/clusters/describe | 95 ------- gcloud/alpha/game/servers/clusters/help | 43 --- gcloud/alpha/game/servers/clusters/list | 117 -------- gcloud/alpha/game/servers/clusters/update | 132 --------- gcloud/alpha/game/servers/configs/create | 142 ---------- gcloud/alpha/game/servers/configs/delete | 87 ------ gcloud/alpha/game/servers/configs/describe | 83 ------ gcloud/alpha/game/servers/configs/help | 40 --- gcloud/alpha/game/servers/deployments/create | 92 ------- gcloud/alpha/game/servers/deployments/delete | 77 ------ .../alpha/game/servers/deployments/describe | 72 ----- .../game/servers/deployments/describe-rollout | 73 ----- .../game/servers/deployments/fetch-state | 74 ----- gcloud/alpha/game/servers/deployments/help | 52 ---- gcloud/alpha/game/servers/deployments/list | 91 ------- gcloud/alpha/game/servers/deployments/update | 120 --------- .../game/servers/deployments/update-rollout | 141 ---------- gcloud/alpha/game/servers/help | 39 --- gcloud/alpha/game/servers/realms/create | 95 ------- gcloud/alpha/game/servers/realms/delete | 76 ------ gcloud/alpha/game/servers/realms/describe | 71 ----- gcloud/alpha/game/servers/realms/update | 134 --------- gcloud/alpha/infra-manager/deployments/apply | 2 +- .../infra-manager/deployments/export-lock | 2 +- .../deployments/export-statefile | 2 +- .../deployments/import-statefile | 2 +- gcloud/alpha/infra-manager/deployments/lock | 2 +- gcloud/alpha/infra-manager/deployments/unlock | 2 +- .../infra-manager/revisions/export-statefile | 2 +- .../vpc-peerings/enable-vpc-service-controls | 36 ++- gcloud/alpha/storage/buckets/create | 10 +- gcloud/alpha/storage/buckets/update | 15 +- gcloud/alpha/storage/cp | 9 +- gcloud/alpha/storage/hash | 2 +- gcloud/alpha/storage/mv | 9 +- gcloud/alpha/storage/objects/update | 9 +- gcloud/alpha/storage/operations/list | 13 +- gcloud/alpha/storage/rsync | 9 +- gcloud/alpha/tasks/cmek-config/describe | 38 +++ .../servers/realms => tasks/cmek-config}/help | 27 +- gcloud/alpha/tasks/cmek-config/update | 70 +++++ gcloud/alpha/tasks/help | 3 + gcloud/alpha/transfer/appliances/delete | 58 ++++ gcloud/alpha/transfer/appliances/describe | 67 +++++ gcloud/alpha/transfer/appliances/help | 40 +++ .../configs => transfer/appliances}/list | 91 ++++--- .../alpha/transfer/appliances/orders/create | 254 ++++++++++++++++++ .../alpha/transfer/appliances/orders/delete | 67 +++++ .../alpha/transfer/appliances/orders/describe | 60 +++++ gcloud/alpha/transfer/appliances/orders/help | 40 +++ .../appliances/orders}/list | 83 ++++-- .../alpha/transfer/appliances/orders/update | 177 ++++++++++++ gcloud/alpha/transfer/help | 3 + gcloud/alpha/workstations/clusters/create | 8 +- gcloud/artifacts/repositories/create | 10 +- gcloud/artifacts/repositories/update | 11 +- gcloud/asset/analyze-iam-policy | 8 + gcloud/asset/analyze-iam-policy-longrunning | 14 +- gcloud/asset/help | 2 +- gcloud/beta/ai/indexes/create | 15 +- gcloud/beta/asset/analyze-iam-policy | 154 +++++++++++ .../beta/asset/analyze-iam-policy-longrunning | 192 +++++++++++++ gcloud/beta/asset/help | 7 + gcloud/beta/builds/help | 4 +- gcloud/beta/builds/repositories/help | 5 +- gcloud/beta/builds/submit | 28 +- gcloud/beta/builds/triggers/help | 2 +- gcloud/beta/builds/triggers/list | 5 +- .../builds/triggers/update/bitbucketserver | 4 +- .../triggers/update/cloud-source-repositories | 5 +- gcloud/beta/builds/triggers/update/github | 4 +- gcloud/beta/builds/triggers/update/gitlab | 4 +- gcloud/beta/builds/triggers/update/help | 15 +- gcloud/beta/builds/triggers/update/manual | 4 +- gcloud/beta/builds/triggers/update/pubsub | 4 +- gcloud/beta/builds/triggers/update/webhook | 4 +- gcloud/beta/builds/worker-pools/create | 4 +- gcloud/beta/builds/worker-pools/describe | 4 +- gcloud/beta/builds/worker-pools/help | 6 +- gcloud/beta/builds/worker-pools/update | 6 +- .../compute/instance-groups/managed/create | 12 + .../compute/instance-groups/managed/update | 12 + gcloud/beta/compute/snapshots/create | 13 + gcloud/beta/config/get | 26 -- gcloud/beta/config/help | 26 -- gcloud/beta/config/list | 26 -- gcloud/beta/config/set | 26 -- gcloud/beta/config/unset | 26 -- gcloud/beta/container/fleet/help | 3 + .../container/fleet/identity-service/apply | 65 ++--- .../policycontroller/content/bundles/help | 31 +++ .../policycontroller/content/bundles/remove | 79 ++++++ .../policycontroller/content/bundles/set | 110 ++++++++ .../fleet/policycontroller/content/help | 31 +++ .../content/templates/disable | 74 +++++ .../policycontroller/content/templates/enable | 75 ++++++ .../policycontroller/content/templates/help | 31 +++ .../fleet/policycontroller/deployment/help | 32 +++ .../fleet/policycontroller/deployment/remove | 136 ++++++++++ .../fleet/policycontroller/deployment/set | 143 ++++++++++ .../container/fleet/policycontroller/describe | 68 +++++ .../container/fleet/policycontroller/detach | 77 ++++++ .../container/fleet/policycontroller/disable | 81 ++++++ .../container/fleet/policycontroller/enable | 179 ++++++++++++ .../container/fleet/policycontroller/help | 52 ++++ .../container/fleet/policycontroller/suspend | 77 ++++++ .../container/fleet/policycontroller/update | 162 +++++++++++ gcloud/beta/container/hub/help | 3 + .../beta/container/hub/identity-service/apply | 65 ++--- .../hub/policycontroller/content/bundles/help | 31 +++ .../policycontroller/content/bundles/remove | 78 ++++++ .../hub/policycontroller/content/bundles/set | 109 ++++++++ .../hub/policycontroller/content/help | 31 +++ .../content/templates/disable | 74 +++++ .../policycontroller/content/templates/enable | 74 +++++ .../policycontroller/content/templates/help | 31 +++ .../hub/policycontroller/deployment/help | 32 +++ .../hub/policycontroller/deployment/remove | 136 ++++++++++ .../hub/policycontroller/deployment/set | 143 ++++++++++ .../container/hub/policycontroller/describe | 68 +++++ .../container/hub/policycontroller/detach | 77 ++++++ .../container/hub/policycontroller/disable | 81 ++++++ .../container/hub/policycontroller/enable | 179 ++++++++++++ .../beta/container/hub/policycontroller/help | 52 ++++ .../container/hub/policycontroller/suspend | 77 ++++++ .../container/hub/policycontroller/update | 161 +++++++++++ gcloud/beta/game/help | 34 --- gcloud/beta/game/locations/describe | 53 ---- gcloud/beta/game/locations/help | 31 --- gcloud/beta/game/locations/list | 68 ----- gcloud/beta/game/operations/describe | 69 ----- gcloud/beta/game/operations/help | 32 --- gcloud/beta/game/operations/list | 89 ------ gcloud/beta/game/servers/clusters/create | 126 --------- gcloud/beta/game/servers/clusters/delete | 95 ------- gcloud/beta/game/servers/clusters/describe | 92 ------- gcloud/beta/game/servers/clusters/help | 41 --- gcloud/beta/game/servers/clusters/list | 115 -------- gcloud/beta/game/servers/clusters/update | 130 --------- gcloud/beta/game/servers/configs/create | 140 ---------- gcloud/beta/game/servers/configs/delete | 85 ------ gcloud/beta/game/servers/configs/describe | 81 ------ gcloud/beta/game/servers/configs/help | 38 --- gcloud/beta/game/servers/configs/list | 105 -------- gcloud/beta/game/servers/deployments/create | 90 ------- gcloud/beta/game/servers/deployments/delete | 75 ------ gcloud/beta/game/servers/deployments/describe | 70 ----- .../game/servers/deployments/describe-rollout | 71 ----- .../beta/game/servers/deployments/fetch-state | 72 ----- gcloud/beta/game/servers/deployments/help | 50 ---- gcloud/beta/game/servers/deployments/list | 89 ------ gcloud/beta/game/servers/deployments/update | 118 -------- .../game/servers/deployments/update-rollout | 139 ---------- gcloud/beta/game/servers/help | 37 --- gcloud/beta/game/servers/realms/create | 93 ------- gcloud/beta/game/servers/realms/delete | 74 ----- gcloud/beta/game/servers/realms/describe | 69 ----- gcloud/beta/game/servers/realms/help | 41 --- gcloud/beta/game/servers/realms/update | 132 --------- .../beta/netapp/backup-vaults/backups/create | 169 ++++++++++++ .../beta/netapp/backup-vaults/backups/delete | 101 +++++++ .../netapp/backup-vaults/backups/describe | 92 +++++++ gcloud/beta/netapp/backup-vaults/backups/help | 36 +++ .../backup-vaults/backups}/list | 70 +++-- .../beta/netapp/backup-vaults/backups/update | 129 +++++++++ gcloud/beta/netapp/backup-vaults/help | 6 + gcloud/beta/netapp/volumes/create | 55 +++- gcloud/beta/netapp/volumes/update | 55 +++- .../vpc-peerings/enable-vpc-service-controls | 36 ++- gcloud/beta/tasks/cmek-config/describe | 36 +++ gcloud/beta/tasks/cmek-config/help | 34 +++ gcloud/beta/tasks/cmek-config/update | 68 +++++ gcloud/beta/tasks/help | 3 + gcloud/beta/workstations/clusters/create | 8 +- gcloud/builds/help | 4 +- gcloud/builds/repositories/help | 4 +- gcloud/builds/submit | 28 +- gcloud/builds/triggers/help | 2 +- gcloud/builds/triggers/list | 5 +- gcloud/builds/triggers/update/bitbucketserver | 4 +- .../triggers/update/cloud-source-repositories | 4 +- gcloud/builds/triggers/update/github | 6 +- gcloud/builds/triggers/update/gitlab | 6 +- gcloud/builds/triggers/update/help | 14 +- gcloud/builds/triggers/update/manual | 4 +- gcloud/builds/triggers/update/pubsub | 4 +- gcloud/builds/triggers/update/webhook | 4 +- gcloud/builds/worker-pools/create | 6 +- gcloud/builds/worker-pools/delete | 5 +- gcloud/builds/worker-pools/describe | 6 +- gcloud/builds/worker-pools/help | 8 +- gcloud/builds/worker-pools/update | 6 +- gcloud/compute/snapshots/create | 17 +- gcloud/config/get | 26 -- gcloud/config/help | 26 -- gcloud/config/list | 26 -- gcloud/config/set | 26 -- gcloud/config/unset | 26 -- gcloud/container/aws/clusters/create | 6 +- gcloud/container/aws/clusters/update | 3 +- gcloud/container/aws/node-pools/create | 3 +- gcloud/container/aws/node-pools/update | 3 +- gcloud/container/fleet/identity-service/apply | 65 ++--- gcloud/container/hub/identity-service/apply | 65 ++--- .../connection-profiles/create/cloudsql | 7 +- gcloud/game/help | 33 --- gcloud/game/locations/describe | 52 ---- gcloud/game/locations/help | 30 --- gcloud/game/locations/list | 67 ----- gcloud/game/operations/describe | 68 ----- gcloud/game/operations/help | 30 --- gcloud/game/operations/list | 88 ------ gcloud/game/servers/clusters/create | 125 --------- gcloud/game/servers/clusters/delete | 94 ------- gcloud/game/servers/clusters/describe | 91 ------- gcloud/game/servers/clusters/help | 39 --- gcloud/game/servers/clusters/list | 114 -------- gcloud/game/servers/clusters/update | 129 --------- gcloud/game/servers/configs/create | 139 ---------- gcloud/game/servers/configs/delete | 84 ------ gcloud/game/servers/configs/describe | 80 ------ gcloud/game/servers/configs/help | 36 --- gcloud/game/servers/configs/list | 104 ------- gcloud/game/servers/deployments/create | 88 ------ gcloud/game/servers/deployments/delete | 74 ----- gcloud/game/servers/deployments/describe | 69 ----- .../game/servers/deployments/describe-rollout | 70 ----- gcloud/game/servers/deployments/fetch-state | 71 ----- gcloud/game/servers/deployments/help | 49 ---- gcloud/game/servers/deployments/list | 88 ------ gcloud/game/servers/deployments/update | 116 -------- .../game/servers/deployments/update-rollout | 138 ---------- gcloud/game/servers/help | 36 --- gcloud/game/servers/realms/create | 91 ------- gcloud/game/servers/realms/delete | 73 ----- gcloud/game/servers/realms/describe | 68 ----- gcloud/game/servers/realms/help | 39 --- gcloud/game/servers/realms/list | 88 ------ gcloud/game/servers/realms/update | 128 --------- gcloud/infra-manager/deployments/apply | 2 +- gcloud/infra-manager/deployments/export-lock | 2 +- .../deployments/export-statefile | 2 +- .../deployments/import-statefile | 2 +- gcloud/infra-manager/deployments/lock | 2 +- gcloud/infra-manager/deployments/unlock | 2 +- .../infra-manager/revisions/export-statefile | 2 +- gcloud/notebooks/instances/help | 3 + gcloud/notebooks/instances/migrate | 79 ++++++ gcloud/run/deploy | 22 ++ gcloud/run/jobs/execute | 31 ++- gcloud/run/services/update | 22 ++ .../vpc-peerings/enable-vpc-service-controls | 35 ++- gcloud/storage/buckets/create | 10 +- gcloud/storage/buckets/update | 15 +- gcloud/storage/cp | 9 +- gcloud/storage/hash | 2 +- gcloud/storage/mv | 9 +- gcloud/storage/objects/update | 9 +- gcloud/storage/operations/list | 13 +- gcloud/storage/rsync | 9 +- gcloud/tasks/cmek-config/describe | 35 +++ gcloud/tasks/cmek-config/help | 31 +++ gcloud/tasks/cmek-config/update | 67 +++++ gcloud/tasks/help | 3 + 371 files changed, 9433 insertions(+), 9676 deletions(-) create mode 100644 gcloud/alpha/asset/analyze-iam-policy create mode 100644 gcloud/alpha/asset/analyze-iam-policy-longrunning create mode 100644 gcloud/alpha/container/fleet/policycontroller/content/bundles/help create mode 100644 gcloud/alpha/container/fleet/policycontroller/content/bundles/remove create mode 100644 gcloud/alpha/container/fleet/policycontroller/content/bundles/set create mode 100644 gcloud/alpha/container/fleet/policycontroller/content/help create mode 100644 gcloud/alpha/container/fleet/policycontroller/content/templates/disable create mode 100644 gcloud/alpha/container/fleet/policycontroller/content/templates/enable create mode 100644 gcloud/alpha/container/fleet/policycontroller/content/templates/help create mode 100644 gcloud/alpha/container/fleet/policycontroller/deployment/help create mode 100644 gcloud/alpha/container/fleet/policycontroller/deployment/remove create mode 100644 gcloud/alpha/container/fleet/policycontroller/deployment/set create mode 100644 gcloud/alpha/container/fleet/policycontroller/describe create mode 100644 gcloud/alpha/container/fleet/policycontroller/detach create mode 100644 gcloud/alpha/container/fleet/policycontroller/disable create mode 100644 gcloud/alpha/container/fleet/policycontroller/enable create mode 100644 gcloud/alpha/container/fleet/policycontroller/suspend create mode 100644 gcloud/alpha/container/fleet/policycontroller/update create mode 100644 gcloud/alpha/container/hub/policycontroller/content/bundles/help create mode 100644 gcloud/alpha/container/hub/policycontroller/content/bundles/remove create mode 100644 gcloud/alpha/container/hub/policycontroller/content/bundles/set create mode 100644 gcloud/alpha/container/hub/policycontroller/content/help create mode 100644 gcloud/alpha/container/hub/policycontroller/content/templates/disable create mode 100644 gcloud/alpha/container/hub/policycontroller/content/templates/enable create mode 100644 gcloud/alpha/container/hub/policycontroller/content/templates/help create mode 100644 gcloud/alpha/container/hub/policycontroller/deployment/help create mode 100644 gcloud/alpha/container/hub/policycontroller/deployment/remove create mode 100644 gcloud/alpha/container/hub/policycontroller/deployment/set create mode 100644 gcloud/alpha/container/hub/policycontroller/describe create mode 100644 gcloud/alpha/container/hub/policycontroller/detach create mode 100644 gcloud/alpha/container/hub/policycontroller/disable create mode 100644 gcloud/alpha/container/hub/policycontroller/enable create mode 100644 gcloud/alpha/container/hub/policycontroller/suspend create mode 100644 gcloud/alpha/container/hub/policycontroller/update delete mode 100644 gcloud/alpha/dataplex/datascan/create delete mode 100644 gcloud/alpha/dataplex/datascan/delete delete mode 100644 gcloud/alpha/dataplex/datascan/describe delete mode 100644 gcloud/alpha/dataplex/datascan/help delete mode 100644 gcloud/alpha/dataplex/datascan/jobs/describe delete mode 100644 gcloud/alpha/dataplex/datascan/jobs/help delete mode 100644 gcloud/alpha/dataplex/datascan/jobs/list delete mode 100644 gcloud/alpha/dataplex/datascan/list delete mode 100644 gcloud/alpha/dataplex/datascan/run delete mode 100644 gcloud/alpha/game/help delete mode 100644 gcloud/alpha/game/locations/describe delete mode 100644 gcloud/alpha/game/locations/help delete mode 100644 gcloud/alpha/game/locations/list delete mode 100644 gcloud/alpha/game/operations/describe delete mode 100644 gcloud/alpha/game/operations/help delete mode 100644 gcloud/alpha/game/operations/list delete mode 100644 gcloud/alpha/game/servers/clusters/create delete mode 100644 gcloud/alpha/game/servers/clusters/delete delete mode 100644 gcloud/alpha/game/servers/clusters/describe delete mode 100644 gcloud/alpha/game/servers/clusters/help delete mode 100644 gcloud/alpha/game/servers/clusters/list delete mode 100644 gcloud/alpha/game/servers/clusters/update delete mode 100644 gcloud/alpha/game/servers/configs/create delete mode 100644 gcloud/alpha/game/servers/configs/delete delete mode 100644 gcloud/alpha/game/servers/configs/describe delete mode 100644 gcloud/alpha/game/servers/configs/help delete mode 100644 gcloud/alpha/game/servers/deployments/create delete mode 100644 gcloud/alpha/game/servers/deployments/delete delete mode 100644 gcloud/alpha/game/servers/deployments/describe delete mode 100644 gcloud/alpha/game/servers/deployments/describe-rollout delete mode 100644 gcloud/alpha/game/servers/deployments/fetch-state delete mode 100644 gcloud/alpha/game/servers/deployments/help delete mode 100644 gcloud/alpha/game/servers/deployments/list delete mode 100644 gcloud/alpha/game/servers/deployments/update delete mode 100644 gcloud/alpha/game/servers/deployments/update-rollout delete mode 100644 gcloud/alpha/game/servers/help delete mode 100644 gcloud/alpha/game/servers/realms/create delete mode 100644 gcloud/alpha/game/servers/realms/delete delete mode 100644 gcloud/alpha/game/servers/realms/describe delete mode 100644 gcloud/alpha/game/servers/realms/update create mode 100644 gcloud/alpha/tasks/cmek-config/describe rename gcloud/alpha/{game/servers/realms => tasks/cmek-config}/help (50%) create mode 100644 gcloud/alpha/tasks/cmek-config/update create mode 100644 gcloud/alpha/transfer/appliances/delete create mode 100644 gcloud/alpha/transfer/appliances/describe create mode 100644 gcloud/alpha/transfer/appliances/help rename gcloud/alpha/{game/servers/configs => transfer/appliances}/list (52%) create mode 100644 gcloud/alpha/transfer/appliances/orders/create create mode 100644 gcloud/alpha/transfer/appliances/orders/delete create mode 100644 gcloud/alpha/transfer/appliances/orders/describe create mode 100644 gcloud/alpha/transfer/appliances/orders/help rename gcloud/alpha/{game/servers/realms => transfer/appliances/orders}/list (50%) create mode 100644 gcloud/alpha/transfer/appliances/orders/update create mode 100644 gcloud/beta/asset/analyze-iam-policy create mode 100644 gcloud/beta/asset/analyze-iam-policy-longrunning create mode 100644 gcloud/beta/container/fleet/policycontroller/content/bundles/help create mode 100644 gcloud/beta/container/fleet/policycontroller/content/bundles/remove create mode 100644 gcloud/beta/container/fleet/policycontroller/content/bundles/set create mode 100644 gcloud/beta/container/fleet/policycontroller/content/help create mode 100644 gcloud/beta/container/fleet/policycontroller/content/templates/disable create mode 100644 gcloud/beta/container/fleet/policycontroller/content/templates/enable create mode 100644 gcloud/beta/container/fleet/policycontroller/content/templates/help create mode 100644 gcloud/beta/container/fleet/policycontroller/deployment/help create mode 100644 gcloud/beta/container/fleet/policycontroller/deployment/remove create mode 100644 gcloud/beta/container/fleet/policycontroller/deployment/set create mode 100644 gcloud/beta/container/fleet/policycontroller/describe create mode 100644 gcloud/beta/container/fleet/policycontroller/detach create mode 100644 gcloud/beta/container/fleet/policycontroller/disable create mode 100644 gcloud/beta/container/fleet/policycontroller/enable create mode 100644 gcloud/beta/container/fleet/policycontroller/help create mode 100644 gcloud/beta/container/fleet/policycontroller/suspend create mode 100644 gcloud/beta/container/fleet/policycontroller/update create mode 100644 gcloud/beta/container/hub/policycontroller/content/bundles/help create mode 100644 gcloud/beta/container/hub/policycontroller/content/bundles/remove create mode 100644 gcloud/beta/container/hub/policycontroller/content/bundles/set create mode 100644 gcloud/beta/container/hub/policycontroller/content/help create mode 100644 gcloud/beta/container/hub/policycontroller/content/templates/disable create mode 100644 gcloud/beta/container/hub/policycontroller/content/templates/enable create mode 100644 gcloud/beta/container/hub/policycontroller/content/templates/help create mode 100644 gcloud/beta/container/hub/policycontroller/deployment/help create mode 100644 gcloud/beta/container/hub/policycontroller/deployment/remove create mode 100644 gcloud/beta/container/hub/policycontroller/deployment/set create mode 100644 gcloud/beta/container/hub/policycontroller/describe create mode 100644 gcloud/beta/container/hub/policycontroller/detach create mode 100644 gcloud/beta/container/hub/policycontroller/disable create mode 100644 gcloud/beta/container/hub/policycontroller/enable create mode 100644 gcloud/beta/container/hub/policycontroller/help create mode 100644 gcloud/beta/container/hub/policycontroller/suspend create mode 100644 gcloud/beta/container/hub/policycontroller/update delete mode 100644 gcloud/beta/game/help delete mode 100644 gcloud/beta/game/locations/describe delete mode 100644 gcloud/beta/game/locations/help delete mode 100644 gcloud/beta/game/locations/list delete mode 100644 gcloud/beta/game/operations/describe delete mode 100644 gcloud/beta/game/operations/help delete mode 100644 gcloud/beta/game/operations/list delete mode 100644 gcloud/beta/game/servers/clusters/create delete mode 100644 gcloud/beta/game/servers/clusters/delete delete mode 100644 gcloud/beta/game/servers/clusters/describe delete mode 100644 gcloud/beta/game/servers/clusters/help delete mode 100644 gcloud/beta/game/servers/clusters/list delete mode 100644 gcloud/beta/game/servers/clusters/update delete mode 100644 gcloud/beta/game/servers/configs/create delete mode 100644 gcloud/beta/game/servers/configs/delete delete mode 100644 gcloud/beta/game/servers/configs/describe delete mode 100644 gcloud/beta/game/servers/configs/help delete mode 100644 gcloud/beta/game/servers/configs/list delete mode 100644 gcloud/beta/game/servers/deployments/create delete mode 100644 gcloud/beta/game/servers/deployments/delete delete mode 100644 gcloud/beta/game/servers/deployments/describe delete mode 100644 gcloud/beta/game/servers/deployments/describe-rollout delete mode 100644 gcloud/beta/game/servers/deployments/fetch-state delete mode 100644 gcloud/beta/game/servers/deployments/help delete mode 100644 gcloud/beta/game/servers/deployments/list delete mode 100644 gcloud/beta/game/servers/deployments/update delete mode 100644 gcloud/beta/game/servers/deployments/update-rollout delete mode 100644 gcloud/beta/game/servers/help delete mode 100644 gcloud/beta/game/servers/realms/create delete mode 100644 gcloud/beta/game/servers/realms/delete delete mode 100644 gcloud/beta/game/servers/realms/describe delete mode 100644 gcloud/beta/game/servers/realms/help delete mode 100644 gcloud/beta/game/servers/realms/update create mode 100644 gcloud/beta/netapp/backup-vaults/backups/create create mode 100644 gcloud/beta/netapp/backup-vaults/backups/delete create mode 100644 gcloud/beta/netapp/backup-vaults/backups/describe create mode 100644 gcloud/beta/netapp/backup-vaults/backups/help rename gcloud/beta/{game/servers/realms => netapp/backup-vaults/backups}/list (53%) create mode 100644 gcloud/beta/netapp/backup-vaults/backups/update create mode 100644 gcloud/beta/tasks/cmek-config/describe create mode 100644 gcloud/beta/tasks/cmek-config/help create mode 100644 gcloud/beta/tasks/cmek-config/update delete mode 100644 gcloud/game/help delete mode 100644 gcloud/game/locations/describe delete mode 100644 gcloud/game/locations/help delete mode 100644 gcloud/game/locations/list delete mode 100644 gcloud/game/operations/describe delete mode 100644 gcloud/game/operations/help delete mode 100644 gcloud/game/operations/list delete mode 100644 gcloud/game/servers/clusters/create delete mode 100644 gcloud/game/servers/clusters/delete delete mode 100644 gcloud/game/servers/clusters/describe delete mode 100644 gcloud/game/servers/clusters/help delete mode 100644 gcloud/game/servers/clusters/list delete mode 100644 gcloud/game/servers/clusters/update delete mode 100644 gcloud/game/servers/configs/create delete mode 100644 gcloud/game/servers/configs/delete delete mode 100644 gcloud/game/servers/configs/describe delete mode 100644 gcloud/game/servers/configs/help delete mode 100644 gcloud/game/servers/configs/list delete mode 100644 gcloud/game/servers/deployments/create delete mode 100644 gcloud/game/servers/deployments/delete delete mode 100644 gcloud/game/servers/deployments/describe delete mode 100644 gcloud/game/servers/deployments/describe-rollout delete mode 100644 gcloud/game/servers/deployments/fetch-state delete mode 100644 gcloud/game/servers/deployments/help delete mode 100644 gcloud/game/servers/deployments/list delete mode 100644 gcloud/game/servers/deployments/update delete mode 100644 gcloud/game/servers/deployments/update-rollout delete mode 100644 gcloud/game/servers/help delete mode 100644 gcloud/game/servers/realms/create delete mode 100644 gcloud/game/servers/realms/delete delete mode 100644 gcloud/game/servers/realms/describe delete mode 100644 gcloud/game/servers/realms/help delete mode 100644 gcloud/game/servers/realms/list delete mode 100644 gcloud/game/servers/realms/update create mode 100644 gcloud/notebooks/instances/migrate create mode 100644 gcloud/tasks/cmek-config/describe create mode 100644 gcloud/tasks/cmek-config/help create mode 100644 gcloud/tasks/cmek-config/update diff --git a/gcloud/_version b/gcloud/_version index 817af7cf7..3d027c77f 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,8 +1,8 @@ -Google Cloud SDK 452.0.1 -alpha 2023.10.25 -beta 2023.10.25 +Google Cloud SDK 453.0.0 +alpha 2023.10.27 +beta 2023.10.27 bq 2.0.98 bundled-python3-unix 3.9.17 -core 2023.10.25 +core 2023.10.27 gcloud-crc32c 1.0.0 gsutil 5.27 diff --git a/gcloud/ai/indexes/create b/gcloud/ai/indexes/create index a34203273..05f185b83 100644 --- a/gcloud/ai/indexes/create +++ b/gcloud/ai/indexes/create @@ -4,16 +4,18 @@ NAME SYNOPSIS gcloud ai indexes create --display-name=DISPLAY_NAME --metadata-file=METADATA_FILE [--description=DESCRIPTION] + [--encryption-kms-key-name=ENCRYPTION_KMS_KEY_NAME] [--index-update-method=INDEX_UPDATE_METHOD] [--labels=[KEY=VALUE,...]] [--metadata-schema-uri=METADATA_SCHEMA_URI] [--region=REGION] [GCLOUD_WIDE_FLAG ...] EXAMPLES - To create an index under project example in region us-central1, run: + To create an index under project example in region us-central1, encrypted + with KMS key kms-key-name, run: $ gcloud ai indexes create --display-name=index --description=test \ --metadata-file=path/to/your/metadata.json --project=example \ - --region=us-central1 + --region=us-central1 --encryption-kms-key-name=kms-key-name REQUIRED FLAGS --display-name=DISPLAY_NAME @@ -27,6 +29,14 @@ OPTIONAL FLAGS --description=DESCRIPTION Description of the index. + --encryption-kms-key-name=ENCRYPTION_KMS_KEY_NAME + The Cloud KMS resource identifier of the customer managed encryption + key used to protect a resource. Has the form: + projects/my-project/locations/my-region/keyRings/my-kr/cryptoKeys/my-key. + + The key needs to be in the same region as where the compute resource is + created. + --index-update-method=INDEX_UPDATE_METHOD The update method to use with this index. Choose stream_update or batch_update. If not set, batch update will be used by default. diff --git a/gcloud/alpha/ai/indexes/create b/gcloud/alpha/ai/indexes/create index 03a19f4eb..40983d0f6 100644 --- a/gcloud/alpha/ai/indexes/create +++ b/gcloud/alpha/ai/indexes/create @@ -4,16 +4,19 @@ NAME SYNOPSIS gcloud alpha ai indexes create --display-name=DISPLAY_NAME --metadata-file=METADATA_FILE [--description=DESCRIPTION] + [--encryption-kms-key-name=ENCRYPTION_KMS_KEY_NAME] [--index-update-method=INDEX_UPDATE_METHOD] [--labels=[KEY=VALUE,...]] [--metadata-schema-uri=METADATA_SCHEMA_URI] [--region=REGION] [GCLOUD_WIDE_FLAG ...] EXAMPLES - To create an index under project example in region us-central1, run: + To create an index under project example in region us-central1, encrypted + with KMS key kms-key-name, run: $ gcloud alpha ai indexes create --display-name=index \ --description=test --metadata-file=path/to/your/metadata.json \ - --project=example --region=us-central1 + --project=example --region=us-central1 \ + --encryption-kms-key-name=kms-key-name REQUIRED FLAGS --display-name=DISPLAY_NAME @@ -27,6 +30,14 @@ OPTIONAL FLAGS --description=DESCRIPTION Description of the index. + --encryption-kms-key-name=ENCRYPTION_KMS_KEY_NAME + The Cloud KMS resource identifier of the customer managed encryption + key used to protect a resource. Has the form: + projects/my-project/locations/my-region/keyRings/my-kr/cryptoKeys/my-key. + + The key needs to be in the same region as where the compute resource is + created. + --index-update-method=INDEX_UPDATE_METHOD The update method to use with this index. Choose stream_update or batch_update. If not set, batch update will be used by default. diff --git a/gcloud/alpha/asset/analyze-iam-policy b/gcloud/alpha/asset/analyze-iam-policy new file mode 100644 index 000000000..5bc9b4ac6 --- /dev/null +++ b/gcloud/alpha/asset/analyze-iam-policy @@ -0,0 +1,161 @@ +NAME + gcloud alpha asset analyze-iam-policy - ALPHA version, Analyzes IAM + policies that match a request + +SYNOPSIS + gcloud alpha asset analyze-iam-policy + (--folder=FOLDER_ID | --organization=ORGANIZATION_ID + | --project=PROJECT_ID) [--access-time=ACCESS_TIME] + [--full-resource-name=FULL_RESOURCE_NAME] [--identity=IDENTITY] + [--saved-analysis-query=SAVED_ANALYSIS_QUERY] + [--analyze-service-account-impersonation + --execution-timeout=EXECUTION_TIMEOUT --expand-groups + --expand-resources --expand-roles --include-deny-policy-analysis + --output-group-edges --output-resource-edges --show-response] + [--permissions=[PERMISSIONS,...] --roles=[ROLES,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Analyzes IAM policies that match a request. + +EXAMPLES + To find out which users have been granted the iam.serviceAccounts.actAs + permission on a service account, run: + + $ gcloud alpha asset analyze-iam-policy --organization=YOUR_ORG_ID \ + --full-resource-name=YOUR_SERVICE_ACCOUNT_FULL_RESOURCE_NAME \ + --permissions='iam.serviceAccounts.actAs' + + To find out which resources a user can access, run: + + $ gcloud alpha asset analyze-iam-policy --organization=YOUR_ORG_ID \ + --identity='user:u1@foo.com' + + To find out which roles or permissions a user has been granted on a + project, run: + + $ gcloud alpha asset analyze-iam-policy --organization=YOUR_ORG_ID \ + --full-resource-name=YOUR_PROJECT_FULL_RESOURCE_NAME \ + --identity='user:u1@foo.com' + + To find out which users have been granted the iam.serviceAccounts.actAs + permission on any applicable resources, run: + + $ gcloud alpha asset analyze-iam-policy --organization=YOUR_ORG_ID \ + --permissions='iam.serviceAccounts.actAs' + +REQUIRED FLAGS + Exactly one of these must be specified: + + --folder=FOLDER_ID + Folder ID on which to perform the analysis. Only policies defined at + or below this folder will be targeted in the analysis. + + --organization=ORGANIZATION_ID + Organization ID on which to perform the analysis. Only policies + defined at or below this organization will be targeted in the + analysis. + + --project=PROJECT_ID + Project ID or number on which to perform the analysis. Only policies + defined at or below this project will be targeted in the analysis. + +OPTIONAL FLAGS + The hypothetical context to evaluate IAM conditions. + + --access-time=ACCESS_TIME + The hypothetical access timestamp to evaluate IAM conditions. + + Specifies a resource for analysis. Leaving it empty means ANY. + + --full-resource-name=FULL_RESOURCE_NAME + The full resource name. + + Specifies an identity for analysis. Leaving it empty means ANY. + + --identity=IDENTITY + The identity appearing in the form of principals in the IAM policy + binding. + + Specifies the name of a saved analysis query. + + --saved-analysis-query=SAVED_ANALYSIS_QUERY + The name of a saved query. When a saved_analysis_query is provided, + its query content will be used as the base query. Other flags' values + will override the base query to compose the final query to run. IDs + might be in one of the following formats: + ▸ projects/project_number/savedQueries/saved_query_id + folders/folder_number/savedQueries/saved_query_id + organizations/organization_number/savedQueries/saved_query_id + + The analysis options. + + --analyze-service-account-impersonation + If true, the response will include access analysis from identities to + resources via service account impersonation. This is a very expensive + operation, because many derived queries will be executed. We highly + recommend you use AnalyzeIamPolicyLongrunning rpc instead. Default is + false. + + --execution-timeout=EXECUTION_TIMEOUT + The amount of time the executable has to complete. See JSON + representation of Duration + (https://developers.google.com/protocol-buffers/docs/proto3#json). + Deafult is empty. + + --expand-groups + If true, the identities section of the result will expand any Google + groups appearing in an IAM policy binding. Default is false. + + --expand-resources + If true, the resource section of the result will expand any resource + attached to an IAM policy to include resources lower in the resource + hierarchy. Default is false. + + --expand-roles + If true, the access section of result will expand any roles appearing + in IAM policy bindings to include their permissions. Default is + false. + + --include-deny-policy-analysis + If true, the response will include analysis for deny policies.This is + a very expensive operation, because many derived queries will be + executed. + + --output-group-edges + If true, the result will output the relevant membership relationships + between groups. Default is false. + + --output-resource-edges + If true, the result will output the relevant parent/child + relationships between resources. Default is false. + + --show-response + If true, the response will be showed as-is in the command output. + + Specifies roles or permissions for analysis. Leaving it empty means ANY. + + --permissions=[PERMISSIONS,...] + The permissions to appear in the result. + + --roles=[ROLES,...] + The roles to appear in the result. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --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 asset analyze-iam-policy + + $ gcloud beta asset analyze-iam-policy + diff --git a/gcloud/alpha/asset/analyze-iam-policy-longrunning b/gcloud/alpha/asset/analyze-iam-policy-longrunning new file mode 100644 index 000000000..28f6d2405 --- /dev/null +++ b/gcloud/alpha/asset/analyze-iam-policy-longrunning @@ -0,0 +1,199 @@ +NAME + gcloud alpha asset analyze-iam-policy-longrunning - analyzes IAM policies + that match a request asynchronously and writes the results to Google + Cloud Storage or BigQuery destination + +SYNOPSIS + gcloud alpha asset analyze-iam-policy-longrunning + (--folder=FOLDER_ID | --organization=ORGANIZATION_ID + | --project=PROJECT_ID) + (--gcs-output-path=GCS_OUTPUT_PATH + | [--bigquery-dataset=BIGQUERY_DATASET + --bigquery-table-prefix=BIGQUERY_TABLE_PREFIX + : --bigquery-partition-key=BIGQUERY_PARTITION_KEY + --bigquery-write-disposition=BIGQUERY_WRITE_DISPOSITION]) + [--access-time=ACCESS_TIME] [--full-resource-name=FULL_RESOURCE_NAME] + [--identity=IDENTITY] + [--analyze-service-account-impersonation --expand-groups + --expand-resources --expand-roles --include-deny-policy-analysis + --output-group-edges --output-resource-edges] + [--permissions=[PERMISSIONS,...] --roles=[ROLES,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Analyzes IAM policies that match a request asynchronously and + writes the results to Google Cloud Storage or BigQuery destination. + +EXAMPLES + To find out which users have been granted the iam.serviceAccounts.actAs + permission on a service account, and write analysis results to Google Cloud + Storage, run: + + $ gcloud alpha asset analyze-iam-policy-longrunning \ + --organization=YOUR_ORG_ID \ + --full-resource-name=YOUR_SERVICE_ACCOUNT_FULL_RESOURCE_NAME \ + --permissions='iam.serviceAccounts.actAs' \ + --gcs-output-path='gs://YOUR_BUCKET_NAME/YOUR_OBJECT_NAME' + + To find out which resources a user can access, and write analysis results + to Google Cloud Storage, run: + + $ gcloud alpha asset analyze-iam-policy-longrunning \ + --organization=YOUR_ORG_ID --identity='user:u1@foo.com' \ + --gcs-output-path='gs://YOUR_BUCKET_NAME/YOUR_OBJECT_NAME' + + To find out which roles or permissions a user has been granted on a + project, and write analysis results to BigQuery, run: + + $ gcloud alpha asset analyze-iam-policy-longrunning \ + --organization=YOUR_ORG_ID \ + --full-resource-name=YOUR_PROJECT_FULL_RESOURCE_NAME \ + --identity='user:u1@foo.com' \ + --bigquery-dataset='projects/YOUR_PROJECT_ID/datasets/YOUR_DATAS\ + ET_ID' --bigquery-table-prefix='YOUR_BIGQUERY_TABLE_PREFIX' + + To find out which users have been granted the iam.serviceAccounts.actAs + permission on any applicable resources, and write analysis results to + BigQuery, run: + + $ gcloud alpha asset analyze-iam-policy-longrunning \ + --organization=YOUR_ORG_ID \ + --permissions='iam.serviceAccounts.actAs' \ + --bigquery-dataset='projects/YOUR_PROJECT_ID/datasets/YOUR_DATAS\ + ET_ID' --bigquery-table-prefix='YOUR_BIGQUERY_TABLE_PREFIX' + +REQUIRED FLAGS + Exactly one of these must be specified: + + --folder=FOLDER_ID + Folder ID on which to perform the analysis. Only policies defined at + or below this folder will be targeted in the analysis. + + --organization=ORGANIZATION_ID + Organization ID on which to perform the analysis. Only policies + defined at or below this organization will be targeted in the + analysis. + + --project=PROJECT_ID + Project ID or number on which to perform the analysis. Only policies + defined at or below this project will be targeted in the analysis. + + The destination path for writing IAM policy analysis results. + + Exactly one of these must be specified: + + --gcs-output-path=GCS_OUTPUT_PATH + Google Cloud Storage URI where the results will be written. URI must + start with "gs://". For example, "gs://bucket_name/object_name". + + BigQuery destination where the results will go. + + --bigquery-dataset=BIGQUERY_DATASET + BigQuery dataset where the results will be written. Must be a + dataset relative name starting with "projects/". For example, + "projects/project_id/datasets/dataset_id". + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --bigquery-table-prefix=BIGQUERY_TABLE_PREFIX + The prefix of the BigQuery tables to which the analysis results + will be written. A table name consists of letters, numbers and + underscores". + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --bigquery-partition-key=BIGQUERY_PARTITION_KEY + This enum determines the partition key column for the bigquery + tables. Partitioning can improve query performance and reduce query + cost by filtering partitions. Refer to + https://cloud.google.com/bigquery/docs/partitioned-tables for + details. BIGQUERY_PARTITION_KEY must be one of: + PARTITION_KEY_UNSPECIFIED, REQUEST_TIME. + + --bigquery-write-disposition=BIGQUERY_WRITE_DISPOSITION + Specifies the action that occurs if the destination table or + partition already exists. The following values are supported: + WRITE_TRUNCATE, WRITE_APPEND and WRITE_EMPTY. The default value is + WRITE_APPEND. + +OPTIONAL FLAGS + The hypothetical context to evaluate IAM conditions. + + --access-time=ACCESS_TIME + The hypothetical access timestamp to evaluate IAM conditions. + + Specifies a resource for analysis. Leaving it empty means ANY. + + --full-resource-name=FULL_RESOURCE_NAME + The full resource name. + + Specifies an identity for analysis. Leaving it empty means ANY. + + --identity=IDENTITY + The identity appearing in the form of principals in the IAM policy + binding. + + The analysis options. + + --analyze-service-account-impersonation + If true, the response will include access analysis from identities to + resources via service account impersonation. This is a very expensive + operation, because many derived queries will be executed. We highly + recommend you use AnalyzeIamPolicyLongrunning rpc instead. Default is + false. + + --expand-groups + If true, the identities section of the result will expand any Google + groups appearing in an IAM policy binding. Default is false. + + --expand-resources + If true, the resource section of the result will expand any resource + attached to an IAM policy to include resources lower in the resource + hierarchy. Default is false. + + --expand-roles + If true, the access section of result will expand any roles appearing + in IAM policy bindings to include their permissions. Default is + false. + + --include-deny-policy-analysis + If true, the response will include analysis for deny policies.This is + a very expensive operation, because many derived queries will be + executed. + + --output-group-edges + If true, the result will output the relevant membership relationships + between groups. Default is false. + + --output-resource-edges + If true, the result will output the relevant parent/child + relationships between resources. Default is false. + + Specifies roles or permissions for analysis. Leaving it empty means ANY. + + --permissions=[PERMISSIONS,...] + The permissions to appear in the result. + + --roles=[ROLES,...] + The roles to appear in the result. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --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 asset analyze-iam-policy-longrunning + + $ gcloud beta asset analyze-iam-policy-longrunning + diff --git a/gcloud/alpha/asset/help b/gcloud/alpha/asset/help index 503c5bcfc..c0479efa2 100644 --- a/gcloud/alpha/asset/help +++ b/gcloud/alpha/asset/help @@ -27,6 +27,13 @@ GROUPS COMMANDS COMMAND is one of the following: + analyze-iam-policy + (ALPHA) ALPHA version, Analyzes IAM policies that match a request. + + analyze-iam-policy-longrunning + (ALPHA) Analyzes IAM policies that match a request asynchronously and + writes the results to Google Cloud Storage or BigQuery destination. + analyze-org-policies (ALPHA) Analyze organization policies under a scope. diff --git a/gcloud/alpha/builds/enterprise-config/bitbucketserver/create b/gcloud/alpha/builds/enterprise-config/bitbucketserver/create index 35b2d5957..c014af7a8 100644 --- a/gcloud/alpha/builds/enterprise-config/bitbucketserver/create +++ b/gcloud/alpha/builds/enterprise-config/bitbucketserver/create @@ -1,6 +1,6 @@ NAME gcloud alpha builds enterprise-config bitbucketserver create - create a - Bitbucket Server config for use by Google Cloud Build + Bitbucket Server config for use by Cloud Build SYNOPSIS gcloud alpha builds enterprise-config bitbucketserver create @@ -15,7 +15,7 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Create a Bitbucket Server config for use by Google Cloud Build. + (ALPHA) Create a Bitbucket Server config for use by Cloud Build. REQUIRED FLAGS --admin-access-token-secret-version=ADMIN_ACCESS_TOKEN_SECRET_VERSION diff --git a/gcloud/alpha/builds/enterprise-config/bitbucketserver/delete b/gcloud/alpha/builds/enterprise-config/bitbucketserver/delete index 64df9b42f..9cc32ad34 100644 --- a/gcloud/alpha/builds/enterprise-config/bitbucketserver/delete +++ b/gcloud/alpha/builds/enterprise-config/bitbucketserver/delete @@ -1,13 +1,13 @@ NAME gcloud alpha builds enterprise-config bitbucketserver delete - delete a - Bitbucket Server config from Google Cloud Build + Bitbucket Server config from Cloud Build SYNOPSIS gcloud alpha builds enterprise-config bitbucketserver delete CONFIG [--region=REGION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Delete a Bitbucket Server config from Google Cloud Build. + (ALPHA) Delete a Bitbucket Server config from Cloud Build. POSITIONAL ARGUMENTS CONFIG diff --git a/gcloud/alpha/builds/enterprise-config/bitbucketserver/help b/gcloud/alpha/builds/enterprise-config/bitbucketserver/help index e4cac3d11..b20dd96ea 100644 --- a/gcloud/alpha/builds/enterprise-config/bitbucketserver/help +++ b/gcloud/alpha/builds/enterprise-config/bitbucketserver/help @@ -1,13 +1,13 @@ NAME gcloud alpha builds enterprise-config bitbucketserver - manage Bitbucket - Server configurations for Google Cloud Build + Server configurations for Cloud Build SYNOPSIS gcloud alpha builds enterprise-config bitbucketserver COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Manage Bitbucket Server configurations for Google Cloud Build. + (ALPHA) Manage Bitbucket Server configurations for Cloud Build. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -18,10 +18,10 @@ COMMANDS COMMAND is one of the following: create - (ALPHA) Create a Bitbucket Server config for use by Google Cloud Build. + (ALPHA) Create a Bitbucket Server config for use by Cloud Build. delete - (ALPHA) Delete a Bitbucket Server config from Google Cloud Build. + (ALPHA) Delete a Bitbucket Server config from Cloud Build. describe (ALPHA) Describe a Bitbucket Server config in a Google Cloud project. @@ -30,7 +30,7 @@ COMMANDS (ALPHA) List all Bitbucket Server configs in a Google Cloud project. update - (ALPHA) Update a Bitbucket Server config for use by Google Cloud Build. + (ALPHA) Update a Bitbucket Server config for use by Cloud Build. NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/builds/enterprise-config/bitbucketserver/update b/gcloud/alpha/builds/enterprise-config/bitbucketserver/update index c9d03ea52..4c3636235 100644 --- a/gcloud/alpha/builds/enterprise-config/bitbucketserver/update +++ b/gcloud/alpha/builds/enterprise-config/bitbucketserver/update @@ -1,6 +1,6 @@ NAME gcloud alpha builds enterprise-config bitbucketserver update - update a - Bitbucket Server config for use by Google Cloud Build + Bitbucket Server config for use by Cloud Build SYNOPSIS gcloud alpha builds enterprise-config bitbucketserver update CONFIG @@ -12,7 +12,7 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Update a Bitbucket Server config for use by Google Cloud Build. + (ALPHA) Update a Bitbucket Server config for use by Cloud Build. POSITIONAL ARGUMENTS CONFIG diff --git a/gcloud/alpha/builds/enterprise-config/github/create b/gcloud/alpha/builds/enterprise-config/github/create index 7746f52fa..e51a590fc 100644 --- a/gcloud/alpha/builds/enterprise-config/github/create +++ b/gcloud/alpha/builds/enterprise-config/github/create @@ -1,6 +1,6 @@ NAME gcloud alpha builds enterprise-config github create - create a GitHub - Enterprise Config for use by Google Cloud Build + Enterprise Config for use by Cloud Build SYNOPSIS gcloud alpha builds enterprise-config github create --app-id=APP_ID @@ -19,7 +19,7 @@ SYNOPSIS [--name=NAME --region=REGION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Create a GitHub Enterprise Config for use by Google Cloud Build. + (ALPHA) Create a GitHub Enterprise Config for use by Cloud Build. REQUIRED FLAGS --app-id=APP_ID diff --git a/gcloud/alpha/builds/enterprise-config/github/delete b/gcloud/alpha/builds/enterprise-config/github/delete index 3c800b657..ba9997add 100644 --- a/gcloud/alpha/builds/enterprise-config/github/delete +++ b/gcloud/alpha/builds/enterprise-config/github/delete @@ -1,13 +1,13 @@ NAME gcloud alpha builds enterprise-config github delete - delete a github - enterprise config from Google Cloud Build + enterprise config from Cloud Build SYNOPSIS gcloud alpha builds enterprise-config github delete CONFIG [--region=REGION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Delete a github enterprise config from Google Cloud Build. + (ALPHA) Delete a github enterprise config from Cloud Build. POSITIONAL ARGUMENTS CONFIG diff --git a/gcloud/alpha/builds/enterprise-config/github/describe b/gcloud/alpha/builds/enterprise-config/github/describe index 94e4ec1db..606f08691 100644 --- a/gcloud/alpha/builds/enterprise-config/github/describe +++ b/gcloud/alpha/builds/enterprise-config/github/describe @@ -1,13 +1,13 @@ NAME gcloud alpha builds enterprise-config github describe - describe a github - enterprise config used by Google Cloud Build + enterprise config used by Cloud Build SYNOPSIS gcloud alpha builds enterprise-config github describe CONFIG [--region=REGION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Describe a github enterprise config used by Google Cloud Build. + (ALPHA) Describe a github enterprise config used by Cloud Build. POSITIONAL ARGUMENTS CONFIG diff --git a/gcloud/alpha/builds/enterprise-config/github/help b/gcloud/alpha/builds/enterprise-config/github/help index d651bacc7..2cd639aa4 100644 --- a/gcloud/alpha/builds/enterprise-config/github/help +++ b/gcloud/alpha/builds/enterprise-config/github/help @@ -1,12 +1,12 @@ NAME gcloud alpha builds enterprise-config github - manage GitHub Enterprise - configurations for Google Cloud Build + configurations for Cloud Build SYNOPSIS gcloud alpha builds enterprise-config github COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Manage GitHub Enterprise configurations for Google Cloud Build. + (ALPHA) Manage GitHub Enterprise configurations for Cloud Build. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -17,20 +17,19 @@ COMMANDS COMMAND is one of the following: create - (ALPHA) Create a GitHub Enterprise Config for use by Google Cloud - Build. + (ALPHA) Create a GitHub Enterprise Config for use by Cloud Build. delete - (ALPHA) Delete a github enterprise config from Google Cloud Build. + (ALPHA) Delete a github enterprise config from Cloud Build. describe - (ALPHA) Describe a github enterprise config used by Google Cloud Build. + (ALPHA) Describe a github enterprise config used by Cloud Build. list (ALPHA) List all github enterprise configs in a Google Cloud project. update - (ALPHA) Update github enterprise config used by Google Cloud Build. + (ALPHA) Update github enterprise config used by Cloud Build. NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/builds/enterprise-config/github/update b/gcloud/alpha/builds/enterprise-config/github/update index 78ff3b821..964c981fc 100644 --- a/gcloud/alpha/builds/enterprise-config/github/update +++ b/gcloud/alpha/builds/enterprise-config/github/update @@ -1,6 +1,6 @@ NAME gcloud alpha builds enterprise-config github update - update github - enterprise config used by Google Cloud Build + enterprise config used by Cloud Build SYNOPSIS gcloud alpha builds enterprise-config github update CONFIG @@ -19,7 +19,7 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Update github enterprise config used by Google Cloud Build. + (ALPHA) Update github enterprise config used by Cloud Build. POSITIONAL ARGUMENTS CONFIG diff --git a/gcloud/alpha/builds/enterprise-config/gitlab/create b/gcloud/alpha/builds/enterprise-config/gitlab/create index 4420740dd..e70442d2b 100644 --- a/gcloud/alpha/builds/enterprise-config/gitlab/create +++ b/gcloud/alpha/builds/enterprise-config/gitlab/create @@ -1,6 +1,6 @@ NAME gcloud alpha builds enterprise-config gitlab create - create a GitLab - Enterprise config for use by Google Cloud Build + Enterprise config for use by Cloud Build SYNOPSIS gcloud alpha builds enterprise-config gitlab create @@ -14,7 +14,7 @@ SYNOPSIS [--ssl-ca-file=SSL_CA_FILE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Create a GitLab Enterprise config for use by Google Cloud Build. + (ALPHA) Create a GitLab Enterprise config for use by Cloud Build. REQUIRED FLAGS --api-access-token-secret-version=API_ACCESS_TOKEN_SECRET_VERSION diff --git a/gcloud/alpha/builds/enterprise-config/gitlab/delete b/gcloud/alpha/builds/enterprise-config/gitlab/delete index edb91387d..15870a794 100644 --- a/gcloud/alpha/builds/enterprise-config/gitlab/delete +++ b/gcloud/alpha/builds/enterprise-config/gitlab/delete @@ -1,13 +1,13 @@ NAME gcloud alpha builds enterprise-config gitlab delete - delete a GitLab - Enterprise config from Google Cloud Build + Enterprise config from Cloud Build SYNOPSIS gcloud alpha builds enterprise-config gitlab delete (CONFIG : --region=REGION) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Delete a GitLab Enterprise config from Google Cloud Build. + (ALPHA) Delete a GitLab Enterprise config from Cloud Build. POSITIONAL ARGUMENTS GitLabConfig resource - GitLab Enterprise config. The arguments in this diff --git a/gcloud/alpha/builds/enterprise-config/gitlab/help b/gcloud/alpha/builds/enterprise-config/gitlab/help index 3dfb8ca11..0db757e90 100644 --- a/gcloud/alpha/builds/enterprise-config/gitlab/help +++ b/gcloud/alpha/builds/enterprise-config/gitlab/help @@ -1,12 +1,12 @@ NAME gcloud alpha builds enterprise-config gitlab - manage GitLab Enterprise - configurations for Google Cloud Build + configurations for Cloud Build SYNOPSIS gcloud alpha builds enterprise-config gitlab COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Manage GitLab Enterprise configurations for Google Cloud Build. + (ALPHA) Manage GitLab Enterprise configurations for Cloud Build. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -17,11 +17,10 @@ COMMANDS COMMAND is one of the following: create - (ALPHA) Create a GitLab Enterprise config for use by Google Cloud - Build. + (ALPHA) Create a GitLab Enterprise config for use by Cloud Build. delete - (ALPHA) Delete a GitLab Enterprise config from Google Cloud Build. + (ALPHA) Delete a GitLab Enterprise config from Cloud Build. describe (ALPHA) Describe a GitLab Enterprise config in a Google Cloud project. @@ -30,8 +29,7 @@ COMMANDS (ALPHA) List all GitLab Enterprise configs in a Google Cloud project. update - (ALPHA) Update a GitLab Enterprise config for use by Google Cloud - Build. + (ALPHA) Update a GitLab Enterprise config for use by Cloud Build. NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/builds/enterprise-config/gitlab/update b/gcloud/alpha/builds/enterprise-config/gitlab/update index 98a9ce15a..b2012e6aa 100644 --- a/gcloud/alpha/builds/enterprise-config/gitlab/update +++ b/gcloud/alpha/builds/enterprise-config/gitlab/update @@ -1,6 +1,6 @@ NAME gcloud alpha builds enterprise-config gitlab update - update a GitLab - Enterprise config for use by Google Cloud Build + Enterprise config for use by Cloud Build SYNOPSIS gcloud alpha builds enterprise-config gitlab update @@ -14,7 +14,7 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Update a GitLab Enterprise config for use by Google Cloud Build. + (ALPHA) Update a GitLab Enterprise config for use by Cloud Build. POSITIONAL ARGUMENTS GitLabConfig resource - GitLab Enterprise config. The arguments in this diff --git a/gcloud/alpha/builds/enterprise-config/help b/gcloud/alpha/builds/enterprise-config/help index e01d6bdd7..c362be520 100644 --- a/gcloud/alpha/builds/enterprise-config/help +++ b/gcloud/alpha/builds/enterprise-config/help @@ -1,12 +1,12 @@ NAME gcloud alpha builds enterprise-config - manage Enterprise configurations - for Google Cloud Build + for Cloud Build SYNOPSIS gcloud alpha builds enterprise-config GROUP [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Manage Enterprise configurations for Google Cloud Build. + (ALPHA) Manage Enterprise configurations for Cloud Build. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -17,13 +17,13 @@ GROUPS GROUP is one of the following: bitbucketserver - (ALPHA) Manage Bitbucket Server configurations for Google Cloud Build. + (ALPHA) Manage Bitbucket Server configurations for Cloud Build. github - (ALPHA) Manage GitHub Enterprise configurations for Google Cloud Build. + (ALPHA) Manage GitHub Enterprise configurations for Cloud Build. gitlab - (ALPHA) Manage GitLab Enterprise configurations for Google Cloud Build. + (ALPHA) Manage GitLab Enterprise configurations for Cloud Build. NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/builds/help b/gcloud/alpha/builds/help index 9cd3f5729..686b701fd 100644 --- a/gcloud/alpha/builds/help +++ b/gcloud/alpha/builds/help @@ -19,10 +19,10 @@ GROUPS (ALPHA) Manage connections for Google Cloud Build. enterprise-config - (ALPHA) Manage Enterprise configurations for Google Cloud Build. + (ALPHA) Manage Enterprise configurations for Cloud Build. repositories - (ALPHA) Manage repositories for Google Cloud Build. + (ALPHA) Manage repositories for Cloud Build. triggers (ALPHA) Create and manage build triggers for Google Cloud Build. @@ -52,7 +52,7 @@ COMMANDS (ALPHA) Reject a pending build. submit - (ALPHA) Submit a build using Google Cloud Build. + (ALPHA) Submit a build using Cloud Build. NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/builds/repositories/help b/gcloud/alpha/builds/repositories/help index 1273711e0..e862f3c85 100644 --- a/gcloud/alpha/builds/repositories/help +++ b/gcloud/alpha/builds/repositories/help @@ -1,12 +1,11 @@ NAME - gcloud alpha builds repositories - manage repositories for Google Cloud - Build + gcloud alpha builds repositories - manage repositories for Cloud Build SYNOPSIS gcloud alpha builds repositories COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Manage repositories for Google Cloud Build. + (ALPHA) Manage repositories for Cloud Build. GCLOUD WIDE FLAGS These flags are available to all commands: --help. diff --git a/gcloud/alpha/builds/submit b/gcloud/alpha/builds/submit index 3619c3bdb..9a94e3b34 100644 --- a/gcloud/alpha/builds/submit +++ b/gcloud/alpha/builds/submit @@ -1,5 +1,5 @@ NAME - gcloud alpha builds submit - submit a build using Google Cloud Build + gcloud alpha builds submit - submit a build using Cloud Build SYNOPSIS gcloud alpha builds submit [[SOURCE] --no-source] [--async] [--no-cache] @@ -16,7 +16,7 @@ SYNOPSIS | --tag=TAG, -t TAG] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Submit a build using Google Cloud Build. + (ALPHA) Submit a build using Cloud Build. When the builds/use_kaniko property is True, builds submitted with --tag will use Kaniko (https://github.com/GoogleContainerTools/kaniko) to execute @@ -42,6 +42,20 @@ EXAMPLES $ gcloud alpha builds submit "source.tgz" \ --tag=gcr.io/my-project/image --async + To submit a build with source from a Git repository + https://github.com/owner/repo: + + $ gcloud alpha builds submit "https://github.com/owner/repo" \ + --git-source-revision=main --config=config.yaml + + To submit a build with source from a 2nd-gen Cloud Build repository + resource + projects/my-project/locations/us-west1/connections/my-conn/repositories/my-repo: + + $ gcloud alpha builds submit \ + "projects/my-project/locations/us-west1/connections/my-conn/repo\ + sitories/my-repo" --revision=main + POSITIONAL ARGUMENTS At most one of these can be specified: @@ -79,10 +93,10 @@ FLAGS --dir=DIR Directory, relative to the source root, in which to run the build. This - is used when the build source is a 2nd-gen Google Cloud Build - repository resource. This must be a relative path. If a step's dir is - specified and is an absolute path, this value is ignored for that - step's execution. + is used when the build source is a 2nd-gen Cloud Build repository + resource. This must be a relative path. If a step's dir is specified + and is an absolute path, this value is ignored for that step's + execution. --disk-size=DISK_SIZE Machine disk size (GB) to run the build. @@ -136,7 +150,7 @@ FLAGS --revision=REVISION Revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref to run the build. This is used when the - build source is a 2nd-gen Google Cloud Build repository resource. + build source is a 2nd-gen Cloud Build repository resource. Cloud Build uses git fetch to fetch the revision from the Git repository; therefore make sure that the string you provide for diff --git a/gcloud/alpha/builds/triggers/config/export b/gcloud/alpha/builds/triggers/config/export index 23f858977..96ccde5f0 100644 --- a/gcloud/alpha/builds/triggers/config/export +++ b/gcloud/alpha/builds/triggers/config/export @@ -1,6 +1,6 @@ NAME gcloud alpha builds triggers config export - export the configuration for a - Google Cloud Build trigger + Cloud Build trigger SYNOPSIS gcloud alpha builds triggers config export ([TRIGGER]] --all) @@ -9,7 +9,7 @@ SYNOPSIS DESCRIPTION (ALPHA) gcloud alpha builds triggers config export exports the - configuration for a Google Cloud Build trigger. + configuration for a Cloud Build trigger. Trigger configurations can be exported in Kubernetes Resource Model (krm) or Terraform HCL formats. The default format is krm. diff --git a/gcloud/alpha/builds/triggers/config/help b/gcloud/alpha/builds/triggers/config/help index c3b88fc12..66fd25ee7 100644 --- a/gcloud/alpha/builds/triggers/config/help +++ b/gcloud/alpha/builds/triggers/config/help @@ -17,7 +17,7 @@ COMMANDS COMMAND is one of the following: export - (ALPHA) Export the configuration for a Google Cloud Build trigger. + (ALPHA) Export the configuration for a Cloud Build trigger. NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/builds/triggers/help b/gcloud/alpha/builds/triggers/help index caafaacca..c619f1980 100644 --- a/gcloud/alpha/builds/triggers/help +++ b/gcloud/alpha/builds/triggers/help @@ -41,7 +41,7 @@ COMMANDS (ALPHA) Import a build trigger. list - (ALPHA) List Google Cloud Build triggers for a project. + (ALPHA) List Cloud Build triggers for a project. run (ALPHA) Run a build trigger. diff --git a/gcloud/alpha/builds/triggers/list b/gcloud/alpha/builds/triggers/list index c6ebb5cd0..2e6542d41 100644 --- a/gcloud/alpha/builds/triggers/list +++ b/gcloud/alpha/builds/triggers/list @@ -1,6 +1,5 @@ NAME - gcloud alpha builds triggers list - list Google Cloud Build triggers for a - project + gcloud alpha builds triggers list - list Cloud Build triggers for a project SYNOPSIS gcloud alpha builds triggers list [--region=REGION] [--filter=EXPRESSION] @@ -8,7 +7,7 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) List Google Cloud Build triggers for a project. + (ALPHA) List Cloud Build triggers for a project. EXAMPLES To list build triggers, run: diff --git a/gcloud/alpha/builds/triggers/update/bitbucketserver b/gcloud/alpha/builds/triggers/update/bitbucketserver index 1e19112f5..0b025dff0 100644 --- a/gcloud/alpha/builds/triggers/update/bitbucketserver +++ b/gcloud/alpha/builds/triggers/update/bitbucketserver @@ -1,6 +1,6 @@ NAME gcloud alpha builds triggers update bitbucketserver - updates Bitbucket - Server trigger used by Google Cloud Build + Server trigger used by Cloud Build SYNOPSIS gcloud alpha builds triggers update bitbucketserver @@ -21,7 +21,7 @@ SYNOPSIS | --update-substitutions=[KEY=VALUE,...]) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Updates Bitbucket Server trigger used by Google Cloud Build. + (ALPHA) Updates Bitbucket Server trigger used by Cloud Build. EXAMPLES To update the branch pattern of the trigger: diff --git a/gcloud/alpha/builds/triggers/update/cloud-source-repositories b/gcloud/alpha/builds/triggers/update/cloud-source-repositories index 3a2331fc1..e726b64ac 100644 --- a/gcloud/alpha/builds/triggers/update/cloud-source-repositories +++ b/gcloud/alpha/builds/triggers/update/cloud-source-repositories @@ -1,6 +1,6 @@ NAME gcloud alpha builds triggers update cloud-source-repositories - updates - Cloud Source Repositories trigger used by Google Cloud Build + Cloud Source Repositories trigger used by Cloud Build SYNOPSIS gcloud alpha builds triggers update cloud-source-repositories @@ -16,8 +16,7 @@ SYNOPSIS | --update-substitutions=[KEY=VALUE,...]) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Updates Cloud Source Repositories trigger used by Google Cloud - Build. + (ALPHA) Updates Cloud Source Repositories trigger used by Cloud Build. EXAMPLES To update the branch pattern of the trigger: diff --git a/gcloud/alpha/builds/triggers/update/github b/gcloud/alpha/builds/triggers/update/github index fe74b1b32..08321de06 100644 --- a/gcloud/alpha/builds/triggers/update/github +++ b/gcloud/alpha/builds/triggers/update/github @@ -1,6 +1,6 @@ NAME gcloud alpha builds triggers update github - update GitHub trigger used by - Google Cloud Build + Cloud Build SYNOPSIS gcloud alpha builds triggers update github (TRIGGER : --region=REGION) @@ -20,7 +20,7 @@ SYNOPSIS --repo-name=REPO_NAME --repo-owner=REPO_OWNER) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Update GitHub trigger used by Google Cloud Build. + (ALPHA) Update GitHub trigger used by Cloud Build. EXAMPLES To update the branch pattern of the trigger: diff --git a/gcloud/alpha/builds/triggers/update/gitlab b/gcloud/alpha/builds/triggers/update/gitlab index 874cf7f96..3bea06fd6 100644 --- a/gcloud/alpha/builds/triggers/update/gitlab +++ b/gcloud/alpha/builds/triggers/update/gitlab @@ -1,6 +1,6 @@ NAME gcloud alpha builds triggers update gitlab - updates GitLab trigger used by - Google Cloud Build + Cloud Build SYNOPSIS gcloud alpha builds triggers update gitlab (TRIGGER : --region=REGION) @@ -17,7 +17,7 @@ SYNOPSIS | --update-substitutions=[KEY=VALUE,...]) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Updates GitLab trigger used by Google Cloud Build. + (ALPHA) Updates GitLab trigger used by Cloud Build. EXAMPLES To update the branch pattern of the trigger: diff --git a/gcloud/alpha/builds/triggers/update/help b/gcloud/alpha/builds/triggers/update/help index 5f5bded8c..d44c7b85b 100644 --- a/gcloud/alpha/builds/triggers/update/help +++ b/gcloud/alpha/builds/triggers/update/help @@ -16,26 +16,25 @@ COMMANDS COMMAND is one of the following: bitbucketserver - (ALPHA) Updates Bitbucket Server trigger used by Google Cloud Build. + (ALPHA) Updates Bitbucket Server trigger used by Cloud Build. cloud-source-repositories - (ALPHA) Updates Cloud Source Repositories trigger used by Google Cloud - Build. + (ALPHA) Updates Cloud Source Repositories trigger used by Cloud Build. github - (ALPHA) Update GitHub trigger used by Google Cloud Build. + (ALPHA) Update GitHub trigger used by Cloud Build. gitlab - (ALPHA) Updates GitLab trigger used by Google Cloud Build. + (ALPHA) Updates GitLab trigger used by Cloud Build. manual - (ALPHA) Updates a manual trigger used by Google Cloud Build. + (ALPHA) Updates a manual trigger used by Cloud Build. pubsub - (ALPHA) Update a Pub/Sub trigger used by Google Cloud Build. + (ALPHA) Update a Pub/Sub trigger used by Cloud Build. webhook - (ALPHA) Update a Webhook trigger used by Google Cloud Build. + (ALPHA) Update a Webhook trigger used by Cloud Build. NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/builds/triggers/update/manual b/gcloud/alpha/builds/triggers/update/manual index 5b0d322ae..abaacfaef 100644 --- a/gcloud/alpha/builds/triggers/update/manual +++ b/gcloud/alpha/builds/triggers/update/manual @@ -1,6 +1,6 @@ NAME gcloud alpha builds triggers update manual - updates a manual trigger used - by Google Cloud Build + by Cloud Build SYNOPSIS gcloud alpha builds triggers update manual (TRIGGER : --region=REGION) @@ -17,7 +17,7 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Updates a manual trigger used by Google Cloud Build. + (ALPHA) Updates a manual trigger used by Cloud Build. EXAMPLES To update the branch from which the trigger clones: diff --git a/gcloud/alpha/builds/triggers/update/pubsub b/gcloud/alpha/builds/triggers/update/pubsub index 18c9302eb..5cfa9e37a 100644 --- a/gcloud/alpha/builds/triggers/update/pubsub +++ b/gcloud/alpha/builds/triggers/update/pubsub @@ -1,6 +1,6 @@ NAME gcloud alpha builds triggers update pubsub - update a Pub/Sub trigger used - by Google Cloud Build + by Cloud Build SYNOPSIS gcloud alpha builds triggers update pubsub (TRIGGER : --region=REGION) @@ -18,7 +18,7 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Update a Pub/Sub trigger used by Google Cloud Build. + (ALPHA) Update a Pub/Sub trigger used by Cloud Build. EXAMPLES To update the branch from which the trigger clones: diff --git a/gcloud/alpha/builds/triggers/update/webhook b/gcloud/alpha/builds/triggers/update/webhook index 23b42eb92..bdc6e18bc 100644 --- a/gcloud/alpha/builds/triggers/update/webhook +++ b/gcloud/alpha/builds/triggers/update/webhook @@ -1,6 +1,6 @@ NAME gcloud alpha builds triggers update webhook - update a Webhook trigger used - by Google Cloud Build + by Cloud Build SYNOPSIS gcloud alpha builds triggers update webhook (TRIGGER : --region=REGION) @@ -18,7 +18,7 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Update a Webhook trigger used by Google Cloud Build. + (ALPHA) Update a Webhook trigger used by Cloud Build. EXAMPLES To update the branch from which the trigger clones: diff --git a/gcloud/alpha/builds/worker-pools/create b/gcloud/alpha/builds/worker-pools/create index 169f5001b..aacd3631c 100644 --- a/gcloud/alpha/builds/worker-pools/create +++ b/gcloud/alpha/builds/worker-pools/create @@ -1,6 +1,6 @@ NAME gcloud alpha builds worker-pools create - create a private or hybrid pool - for use by Google Cloud Build + for use by Cloud Build SYNOPSIS gcloud alpha builds worker-pools create WORKER_POOL --region=REGION @@ -10,7 +10,7 @@ SYNOPSIS --worker-machine-type=WORKER_MACHINE_TYPE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Create a private or hybrid pool for use by Google Cloud Build. + (ALPHA) Create a private or hybrid pool for use by Cloud Build. EXAMPLES ▪ Private pools diff --git a/gcloud/alpha/builds/worker-pools/describe b/gcloud/alpha/builds/worker-pools/describe index 597b77916..b7a1b4d7b 100644 --- a/gcloud/alpha/builds/worker-pools/describe +++ b/gcloud/alpha/builds/worker-pools/describe @@ -1,14 +1,13 @@ NAME gcloud alpha builds worker-pools describe - describe a private or hybrid - worker pool used by Google Cloud Build + worker pool used by Cloud Build SYNOPSIS gcloud alpha builds worker-pools describe WORKER_POOL --region=REGION [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Describe a private or hybrid worker pool used by Google Cloud - Build. + (ALPHA) Describe a private or hybrid worker pool used by Cloud Build. EXAMPLES To get information about a private or hybrid worker pool named wp1 in diff --git a/gcloud/alpha/builds/worker-pools/help b/gcloud/alpha/builds/worker-pools/help index bc2bed948..d1212fa0b 100644 --- a/gcloud/alpha/builds/worker-pools/help +++ b/gcloud/alpha/builds/worker-pools/help @@ -17,21 +17,20 @@ COMMANDS COMMAND is one of the following: create - (ALPHA) Create a private or hybrid pool for use by Google Cloud Build. + (ALPHA) Create a private or hybrid pool for use by Cloud Build. delete (ALPHA) Delete a private or hybrid worker pool from Google Cloud Build. describe - (ALPHA) Describe a private or hybrid worker pool used by Google Cloud - Build. + (ALPHA) Describe a private or hybrid worker pool used by Cloud Build. list (ALPHA) List all private and hybrid worker pools in a Google Cloud project. update - (ALPHA) Update a private or hybrid pool used by Google Cloud Build. + (ALPHA) Update a private or hybrid pool used by Cloud Build. NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/builds/worker-pools/update b/gcloud/alpha/builds/worker-pools/update index b8c1d86bb..78fe5d125 100644 --- a/gcloud/alpha/builds/worker-pools/update +++ b/gcloud/alpha/builds/worker-pools/update @@ -1,6 +1,6 @@ NAME gcloud alpha builds worker-pools update - update a private or hybrid pool - used by Google Cloud Build + used by Cloud Build SYNOPSIS gcloud alpha builds worker-pools update WORKER_POOL --region=REGION @@ -9,7 +9,7 @@ SYNOPSIS --worker-machine-type=WORKER_MACHINE_TYPE) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Update a private or hybrid pool used by Google Cloud Build. + (ALPHA) Update a private or hybrid pool used by Cloud Build. EXAMPLES ▪ Private pools diff --git a/gcloud/alpha/compute/snapshots/create b/gcloud/alpha/compute/snapshots/create index 6f4784579..fc861b351 100644 --- a/gcloud/alpha/compute/snapshots/create +++ b/gcloud/alpha/compute/snapshots/create @@ -7,6 +7,8 @@ SYNOPSIS [--description=DESCRIPTION] [--guest-flush] [--labels=[KEY=VALUE,...]] [--max-retention-days=MAX_RETENTION_DAYS] [--snapshot-type=SNAPSHOT_TYPE] [--source-disk=SOURCE_DISK] + [--source-disk-for-recovery-checkpoint=SOURCE_DISK_FOR_RECOVERY_CHECKPOINT] + [--source-disk-for-recovery-checkpoint-region=SOURCE_DISK_FOR_RECOVERY_CHECKPOINT_REGION] [--source-disk-key-file=FILE] [--source-instant-snapshot=SOURCE_INSTANT_SNAPSHOT] [--source-instant-snapshot-key-file=FILE] [--storage-location=LOCATION] @@ -86,6 +88,17 @@ FLAGS disk. For example: https://www.googleapis.com/compute/v1/projects/MY-PROJECT/zones/MY-ZONE/disks/MY-DISK + --source-disk-for-recovery-checkpoint=SOURCE_DISK_FOR_RECOVERY_CHECKPOINT + Source disk whose recovery checkpoint used to create the snapshot. To + create a snapshot from the recovery checkpoint of a source disk in a + different project, specify the full path to the source disk. For + example: projects/MY-PROJECT/regions/MY-REGION/disks/MY-DISK + + --source-disk-for-recovery-checkpoint-region=SOURCE_DISK_FOR_RECOVERY_CHECKPOINT_REGION + Region of the source disk for recovery checkpoint to operate on. + Overrides the default compute/region property value for this command + invocation. + --source-disk-key-file=FILE Path to the customer-supplied encryption key of the source disk. Required if the source disk is protected by a customer-supplied diff --git a/gcloud/alpha/compute/start-iap-tunnel b/gcloud/alpha/compute/start-iap-tunnel index de70c176e..65a172fc7 100644 --- a/gcloud/alpha/compute/start-iap-tunnel +++ b/gcloud/alpha/compute/start-iap-tunnel @@ -88,13 +88,18 @@ FLAGS --region=REGION Configures the region to use when connecting via IP address or FQDN. - --network=NETWORK - Configures the VPC network to use when connecting via IP address or - FQDN. + At most one of these can be specified: - --dest-group=DEST_GROUP - Configures the destination group to use when connecting via IP address - or FQDN. + --network=NETWORK + Configures the VPC network to use when connecting via IP address or + FQDN. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --dest-group=DEST_GROUP + Configures the destination group to use when connecting via IP + address or FQDN. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/compute/tpus/queued-resources/create b/gcloud/alpha/compute/tpus/queued-resources/create index 7ae4e9055..fc41a8a52 100644 --- a/gcloud/alpha/compute/tpus/queued-resources/create +++ b/gcloud/alpha/compute/tpus/queued-resources/create @@ -100,7 +100,7 @@ REQUIRED FLAGS in this group are specified. --type=TYPE - Type of TPU. TYPE must be one of: v2, v3, v4. + Type of TPU. TYPE must be one of: v2, v3, v4, v5litepod. This flag argument must be specified if any of the other arguments in this group are specified. diff --git a/gcloud/alpha/compute/tpus/tpu-vm/create b/gcloud/alpha/compute/tpus/tpu-vm/create index 115aff3e3..3614bffe9 100644 --- a/gcloud/alpha/compute/tpus/tpu-vm/create +++ b/gcloud/alpha/compute/tpus/tpu-vm/create @@ -225,7 +225,7 @@ OPTIONAL FLAGS in this group are specified. --type=TYPE - Type of TPU. TYPE must be one of: v2, v3, v4. + Type of TPU. TYPE must be one of: v2, v3, v4, v5litepod. This flag argument must be specified if any of the other arguments in this group are specified. diff --git a/gcloud/alpha/config/get b/gcloud/alpha/config/get index 2e294e1c3..5e96eb052 100644 --- a/gcloud/alpha/config/get +++ b/gcloud/alpha/config/get @@ -298,10 +298,6 @@ AVAILABLE PROPERTIES Private Service Connect usage, see https://cloud.google.com/vpc/docs/configure-private-service-connect-apis#using-endpoints - config - Overrides API endpoint for gcloud blueprints command group. - Defaults to https://config.googleapis.com/ - container Overrides API endpoint for gcloud container command group. Defaults to https://container.googleapis.com/ @@ -382,10 +378,6 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud firestore command group. Defaults to https://firestore.googleapis.com/ - gameservices - Overrides API endpoint for gcloud gamer command group. Defaults to - https://gameservices.googleapis.com/ - genomics Overrides API endpoint for gcloud genomics command group. Defaults to https://genomics.googleapis.com/ @@ -920,24 +912,6 @@ AVAILABLE PROPERTIES fall back to this value, if set. To see valid choices, run gcloud beta functions regions list. - game_services - default_deployment - Default deployment to use when working with Cloud Game Services - list configs. When a --deployment flag is required in a list - command but not provided, the command will fall back to this value - which envokes aggregated list from the backend. - - default_realm - Default realm to use when working with Cloud Game Services list - clusters. When a --realm flag is required in a list command but not - provided, the command will fall back to this value which envokes - aggregated list from the backend. - - location - Default location to use when working with Cloud Game Services - resources. When a --location flag is required but not provided, the - command will fall back to this value. - gcloudignore enabled If True, do not upload .gcloudignore files (see $ gcloud topic diff --git a/gcloud/alpha/config/help b/gcloud/alpha/config/help index 3e2727950..f1f260997 100644 --- a/gcloud/alpha/config/help +++ b/gcloud/alpha/config/help @@ -330,10 +330,6 @@ AVAILABLE PROPERTIES Private Service Connect usage, see https://cloud.google.com/vpc/docs/configure-private-service-connect-apis#using-endpoints - config - Overrides API endpoint for gcloud blueprints command group. - Defaults to https://config.googleapis.com/ - container Overrides API endpoint for gcloud container command group. Defaults to https://container.googleapis.com/ @@ -414,10 +410,6 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud firestore command group. Defaults to https://firestore.googleapis.com/ - gameservices - Overrides API endpoint for gcloud gamer command group. Defaults to - https://gameservices.googleapis.com/ - genomics Overrides API endpoint for gcloud genomics command group. Defaults to https://genomics.googleapis.com/ @@ -952,24 +944,6 @@ AVAILABLE PROPERTIES fall back to this value, if set. To see valid choices, run gcloud beta functions regions list. - game_services - default_deployment - Default deployment to use when working with Cloud Game Services - list configs. When a --deployment flag is required in a list - command but not provided, the command will fall back to this value - which envokes aggregated list from the backend. - - default_realm - Default realm to use when working with Cloud Game Services list - clusters. When a --realm flag is required in a list command but not - provided, the command will fall back to this value which envokes - aggregated list from the backend. - - location - Default location to use when working with Cloud Game Services - resources. When a --location flag is required but not provided, the - command will fall back to this value. - gcloudignore enabled If True, do not upload .gcloudignore files (see $ gcloud topic diff --git a/gcloud/alpha/config/list b/gcloud/alpha/config/list index 2a388fd62..d2c5896bf 100644 --- a/gcloud/alpha/config/list +++ b/gcloud/alpha/config/list @@ -342,10 +342,6 @@ AVAILABLE PROPERTIES Private Service Connect usage, see https://cloud.google.com/vpc/docs/configure-private-service-connect-apis#using-endpoints - config - Overrides API endpoint for gcloud blueprints command group. - Defaults to https://config.googleapis.com/ - container Overrides API endpoint for gcloud container command group. Defaults to https://container.googleapis.com/ @@ -426,10 +422,6 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud firestore command group. Defaults to https://firestore.googleapis.com/ - gameservices - Overrides API endpoint for gcloud gamer command group. Defaults to - https://gameservices.googleapis.com/ - genomics Overrides API endpoint for gcloud genomics command group. Defaults to https://genomics.googleapis.com/ @@ -964,24 +956,6 @@ AVAILABLE PROPERTIES fall back to this value, if set. To see valid choices, run gcloud beta functions regions list. - game_services - default_deployment - Default deployment to use when working with Cloud Game Services - list configs. When a --deployment flag is required in a list - command but not provided, the command will fall back to this value - which envokes aggregated list from the backend. - - default_realm - Default realm to use when working with Cloud Game Services list - clusters. When a --realm flag is required in a list command but not - provided, the command will fall back to this value which envokes - aggregated list from the backend. - - location - Default location to use when working with Cloud Game Services - resources. When a --location flag is required but not provided, the - command will fall back to this value. - gcloudignore enabled If True, do not upload .gcloudignore files (see $ gcloud topic diff --git a/gcloud/alpha/config/set b/gcloud/alpha/config/set index cc02a582e..3c77607d4 100644 --- a/gcloud/alpha/config/set +++ b/gcloud/alpha/config/set @@ -345,10 +345,6 @@ AVAILABLE PROPERTIES Private Service Connect usage, see https://cloud.google.com/vpc/docs/configure-private-service-connect-apis#using-endpoints - config - Overrides API endpoint for gcloud blueprints command group. - Defaults to https://config.googleapis.com/ - container Overrides API endpoint for gcloud container command group. Defaults to https://container.googleapis.com/ @@ -429,10 +425,6 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud firestore command group. Defaults to https://firestore.googleapis.com/ - gameservices - Overrides API endpoint for gcloud gamer command group. Defaults to - https://gameservices.googleapis.com/ - genomics Overrides API endpoint for gcloud genomics command group. Defaults to https://genomics.googleapis.com/ @@ -967,24 +959,6 @@ AVAILABLE PROPERTIES fall back to this value, if set. To see valid choices, run gcloud beta functions regions list. - game_services - default_deployment - Default deployment to use when working with Cloud Game Services - list configs. When a --deployment flag is required in a list - command but not provided, the command will fall back to this value - which envokes aggregated list from the backend. - - default_realm - Default realm to use when working with Cloud Game Services list - clusters. When a --realm flag is required in a list command but not - provided, the command will fall back to this value which envokes - aggregated list from the backend. - - location - Default location to use when working with Cloud Game Services - resources. When a --location flag is required but not provided, the - command will fall back to this value. - gcloudignore enabled If True, do not upload .gcloudignore files (see $ gcloud topic diff --git a/gcloud/alpha/config/unset b/gcloud/alpha/config/unset index 4871fc32c..b70ad341b 100644 --- a/gcloud/alpha/config/unset +++ b/gcloud/alpha/config/unset @@ -306,10 +306,6 @@ AVAILABLE PROPERTIES Private Service Connect usage, see https://cloud.google.com/vpc/docs/configure-private-service-connect-apis#using-endpoints - config - Overrides API endpoint for gcloud blueprints command group. - Defaults to https://config.googleapis.com/ - container Overrides API endpoint for gcloud container command group. Defaults to https://container.googleapis.com/ @@ -390,10 +386,6 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud firestore command group. Defaults to https://firestore.googleapis.com/ - gameservices - Overrides API endpoint for gcloud gamer command group. Defaults to - https://gameservices.googleapis.com/ - genomics Overrides API endpoint for gcloud genomics command group. Defaults to https://genomics.googleapis.com/ @@ -928,24 +920,6 @@ AVAILABLE PROPERTIES fall back to this value, if set. To see valid choices, run gcloud beta functions regions list. - game_services - default_deployment - Default deployment to use when working with Cloud Game Services - list configs. When a --deployment flag is required in a list - command but not provided, the command will fall back to this value - which envokes aggregated list from the backend. - - default_realm - Default realm to use when working with Cloud Game Services list - clusters. When a --realm flag is required in a list command but not - provided, the command will fall back to this value which envokes - aggregated list from the backend. - - location - Default location to use when working with Cloud Game Services - resources. When a --location flag is required but not provided, the - command will fall back to this value. - gcloudignore enabled If True, do not upload .gcloudignore files (see $ gcloud topic diff --git a/gcloud/alpha/container/aws/clusters/create b/gcloud/alpha/container/aws/clusters/create index 15eb27aae..b868b8cc0 100644 --- a/gcloud/alpha/container/aws/clusters/create +++ b/gcloud/alpha/container/aws/clusters/create @@ -186,7 +186,8 @@ OPTIONAL FLAGS --main-volume-throughput=MAIN_VOLUME_THROUGHPUT Throughput to provision for the main volume, in MiB/s. Only valid if - the volume type is GP3. + the volume type is GP3. If volume type is GP3 and throughput is not + provided, it defaults to 125. --main-volume-type=MAIN_VOLUME_TYPE Type of the main volume. MAIN_VOLUME_TYPE must be one of: gp2, gp3. @@ -209,7 +210,8 @@ OPTIONAL FLAGS --root-volume-throughput=ROOT_VOLUME_THROUGHPUT Throughput to provision for the root volume, in MiB/s. Only valid if - the volume type is GP3. + the volume type is GP3. If volume type is GP3 and throughput is not + provided, it defaults to 125. --root-volume-type=ROOT_VOLUME_TYPE Type of the root volume. ROOT_VOLUME_TYPE must be one of: gp2, gp3. diff --git a/gcloud/alpha/container/aws/clusters/update b/gcloud/alpha/container/aws/clusters/update index 89e30ebae..f933b6f1c 100644 --- a/gcloud/alpha/container/aws/clusters/update +++ b/gcloud/alpha/container/aws/clusters/update @@ -129,7 +129,8 @@ FLAGS --root-volume-throughput=ROOT_VOLUME_THROUGHPUT Throughput to provision for the root volume, in MiB/s. Only valid if - the volume type is GP3. + the volume type is GP3. If volume type is GP3 and throughput is not + provided, it defaults to 125. --root-volume-type=ROOT_VOLUME_TYPE Type of the root volume. ROOT_VOLUME_TYPE must be one of: gp2, gp3. diff --git a/gcloud/alpha/container/aws/node-pools/create b/gcloud/alpha/container/aws/node-pools/create index 66b9feb73..6af7054ea 100644 --- a/gcloud/alpha/container/aws/node-pools/create +++ b/gcloud/alpha/container/aws/node-pools/create @@ -189,7 +189,8 @@ OPTIONAL FLAGS --root-volume-throughput=ROOT_VOLUME_THROUGHPUT Throughput to provision for the root volume, in MiB/s. Only valid if - the volume type is GP3. + the volume type is GP3. If volume type is GP3 and throughput is not + provided, it defaults to 125. --root-volume-type=ROOT_VOLUME_TYPE Type of the root volume. ROOT_VOLUME_TYPE must be one of: gp2, gp3. diff --git a/gcloud/alpha/container/aws/node-pools/update b/gcloud/alpha/container/aws/node-pools/update index b15dbf232..5ec1a7c11 100644 --- a/gcloud/alpha/container/aws/node-pools/update +++ b/gcloud/alpha/container/aws/node-pools/update @@ -139,7 +139,8 @@ FLAGS --root-volume-throughput=ROOT_VOLUME_THROUGHPUT Throughput to provision for the root volume, in MiB/s. Only valid if - the volume type is GP3. + the volume type is GP3. If volume type is GP3 and throughput is not + provided, it defaults to 125. --root-volume-type=ROOT_VOLUME_TYPE Type of the root volume. ROOT_VOLUME_TYPE must be one of: gp2, gp3. diff --git a/gcloud/alpha/container/fleet/identity-service/apply b/gcloud/alpha/container/fleet/identity-service/apply index 6170d182f..5236cb848 100644 --- a/gcloud/alpha/container/fleet/identity-service/apply +++ b/gcloud/alpha/container/fleet/identity-service/apply @@ -3,8 +3,9 @@ NAME Service Feature Spec SYNOPSIS - gcloud alpha container fleet identity-service apply --config=CONFIG - [--membership=MEMBERSHIP : --location=LOCATION] [GCLOUD_WIDE_FLAG ...] + gcloud alpha container fleet identity-service apply + ([--config=CONFIG : [--membership=MEMBERSHIP : --location=LOCATION]]) + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Applies the authentication configuration to the Identity Service @@ -15,46 +16,50 @@ DESCRIPTION you run this command. EXAMPLES - To apply an Identity Service configuration for a membership, run: + To apply an Identity Service configuration to a membership, run: $ gcloud alpha container fleet identity-service apply \ --membership=MEMBERSHIP_NAME \ --config=/path/to/identity-service.yaml REQUIRED FLAGS - --config=CONFIG - The path to the identity-service.yaml config file. + At least one of these must be specified: -OPTIONAL FLAGS - Membership resource - The group of arguments defining a membership. 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 --membership on the command line with a fully - specified name; - ◆ provide the argument --project on the command line; - ◆ set the property core/project. - - --membership=MEMBERSHIP - ID of the membership or fully qualified identifier for the - membership. - - To set the membership attribute: - ▸ provide the argument --membership on the command line. + --config=CONFIG + The path to an identity-service.yaml config file. This flag argument must be specified if any of the other arguments in this group are specified. - --location=LOCATION - Location for the membership. + Membership resource - The group of arguments defining a membership. 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 location attribute: - ▸ provide the argument --membership on the command line with a - fully specified name; - ▸ provide the argument --location on the command line; - ▸ set the property gkehub/location. + To set the project attribute: + ▸ provide the argument --membership on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --membership=MEMBERSHIP + ID of the membership or fully qualified identifier for the + membership. + + To set the membership attribute: + ▫ provide the argument --membership on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the membership. + + To set the location attribute: + ▫ provide the argument --membership on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/container/fleet/policycontroller/content/bundles/help b/gcloud/alpha/container/fleet/policycontroller/content/bundles/help new file mode 100644 index 000000000..22fa7d2f2 --- /dev/null +++ b/gcloud/alpha/container/fleet/policycontroller/content/bundles/help @@ -0,0 +1,33 @@ +NAME + gcloud alpha container fleet policycontroller content bundles - manage + Policy Controller content bundles + +SYNOPSIS + gcloud alpha container fleet policycontroller content bundles COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Policy Controller content bundles. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + remove + (ALPHA) Removes a bundle installation for Policy Controller content. + + set + (ALPHA) Sets bundle installation for Policy Controller content. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta container fleet policycontroller content bundles + diff --git a/gcloud/alpha/container/fleet/policycontroller/content/bundles/remove b/gcloud/alpha/container/fleet/policycontroller/content/bundles/remove new file mode 100644 index 000000000..3fbe00c1e --- /dev/null +++ b/gcloud/alpha/container/fleet/policycontroller/content/bundles/remove @@ -0,0 +1,80 @@ +NAME + gcloud alpha container fleet policycontroller content bundles remove - + removes a bundle installation for Policy Controller content + +SYNOPSIS + gcloud alpha container fleet policycontroller content bundles remove + BUNDLE_NAME + [--all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Google-defined policy bundles of constraints can be installed onto + Policy Controller installations. This command removes those bundles. + +EXAMPLES + To remove a policy bundle: + + $ gcloud alpha container fleet policycontroller content bundles \ + remove cis-k8s-v1.5.1 + +POSITIONAL ARGUMENTS + BUNDLE_NAME + The constraint bundle to remove from Policy Controller. + +FLAGS + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▸ provide the argument --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta container fleet policycontroller content bundles remove + diff --git a/gcloud/alpha/container/fleet/policycontroller/content/bundles/set b/gcloud/alpha/container/fleet/policycontroller/content/bundles/set new file mode 100644 index 000000000..534b2d3d0 --- /dev/null +++ b/gcloud/alpha/container/fleet/policycontroller/content/bundles/set @@ -0,0 +1,112 @@ +NAME + gcloud alpha container fleet policycontroller content bundles set - sets + bundle installation for Policy Controller content + +SYNOPSIS + gcloud alpha container fleet policycontroller content bundles set + BUNDLE_NAME + [--all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [--exempted-namespaces=EXEMPTED_NAMESPACES | --no-exempted-namespaces] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Google-defined policy bundles of constraints can be installed onto + Policy Controller installations. + + The namespace exclusion flag (--exempted-namespaces) will specify a set of + namespaces that the installed bundle will ignore. Subsequent calls with the + same bundle name and this flag will overwrite what namespaces are being + ignored. Using --no-exempted-namespaces or specifying no namespaces with + --exempted-namespaces will remove all namespaces from the ignore list. + + To uninstall a bundle, use the remove command. + +EXAMPLES + To install a policy bundle: + + $ gcloud alpha container fleet policycontroller content bundles \ + set cis-k8s-v1.5.1 + + To install a policy bundle, while ignoring (exempting) certain namespaces + from being affected by the bundle: + + $ gcloud alpha container fleet policycontroller content bundles \ + set cis-k8s-v1.5.1 \ + --exempted-namespaces=kube-system,gatekeeper-system + + To remove all exempted namespaces from a particular bundles ignore list: + + $ gcloud alpha container fleet policycontroller content bundles \ + set cis-k8s-v1.5.1 --no-exempted-namespaces + +POSITIONAL ARGUMENTS + BUNDLE_NAME + The constraint bundle to install in Policy Controller. + +FLAGS + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▸ provide the argument --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. + + Exempted Namespaces flags. + + At most one of these can be specified: + + --exempted-namespaces=EXEMPTED_NAMESPACES + Exempted namespaces are ignored by Policy Controller when applying + constraints added by this bundle. + + --no-exempted-namespaces + Removes all exempted namespaces from the specified 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. This variant is also available: + + $ gcloud beta container fleet policycontroller content bundles set + diff --git a/gcloud/alpha/container/fleet/policycontroller/content/help b/gcloud/alpha/container/fleet/policycontroller/content/help new file mode 100644 index 000000000..374fcb4cd --- /dev/null +++ b/gcloud/alpha/container/fleet/policycontroller/content/help @@ -0,0 +1,33 @@ +NAME + gcloud alpha container fleet policycontroller content - manage Policy + Controller content + +SYNOPSIS + gcloud alpha container fleet policycontroller content GROUP + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Policy Controller content. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + bundles + (ALPHA) Manage Policy Controller content bundles. + + templates + (ALPHA) Manage Policy Controller content templates. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta container fleet policycontroller content + diff --git a/gcloud/alpha/container/fleet/policycontroller/content/templates/disable b/gcloud/alpha/container/fleet/policycontroller/content/templates/disable new file mode 100644 index 000000000..a7e35351a --- /dev/null +++ b/gcloud/alpha/container/fleet/policycontroller/content/templates/disable @@ -0,0 +1,76 @@ +NAME + gcloud alpha container fleet policycontroller content templates disable - + disable template installation for Policy Controller content + +SYNOPSIS + gcloud alpha container fleet policycontroller content templates disable + [--all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) The Google-defined template library can be installed onto Policy + Controller installations. This command removes that template library. + +EXAMPLES + To remove the template library: + + $ gcloud alpha container fleet policycontroller content templates \ + disable + +FLAGS + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▸ provide the argument --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta container fleet policycontroller content templates \ + disable + diff --git a/gcloud/alpha/container/fleet/policycontroller/content/templates/enable b/gcloud/alpha/container/fleet/policycontroller/content/templates/enable new file mode 100644 index 000000000..db9bc5714 --- /dev/null +++ b/gcloud/alpha/container/fleet/policycontroller/content/templates/enable @@ -0,0 +1,77 @@ +NAME + gcloud alpha container fleet policycontroller content templates enable - + installs the template library for Policy Controller + +SYNOPSIS + gcloud alpha container fleet policycontroller content templates enable + [--all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Google-defined template library can be installed onto Policy + Controller installations. To uninstall the template library, use the + disable command. + +EXAMPLES + To install a template library: + + $ gcloud alpha container fleet policycontroller content templates \ + enable + +FLAGS + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▸ provide the argument --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta container fleet policycontroller content templates \ + enable + diff --git a/gcloud/alpha/container/fleet/policycontroller/content/templates/help b/gcloud/alpha/container/fleet/policycontroller/content/templates/help new file mode 100644 index 000000000..d6eaa4d10 --- /dev/null +++ b/gcloud/alpha/container/fleet/policycontroller/content/templates/help @@ -0,0 +1,33 @@ +NAME + gcloud alpha container fleet policycontroller content templates - manage + Policy Controller content templates + +SYNOPSIS + gcloud alpha container fleet policycontroller content templates COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Policy Controller content templates. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + disable + (ALPHA) Disable template installation for Policy Controller content. + + enable + (ALPHA) Installs the template library for Policy Controller. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta container fleet policycontroller content templates + diff --git a/gcloud/alpha/container/fleet/policycontroller/deployment/help b/gcloud/alpha/container/fleet/policycontroller/deployment/help new file mode 100644 index 000000000..faa0181d2 --- /dev/null +++ b/gcloud/alpha/container/fleet/policycontroller/deployment/help @@ -0,0 +1,34 @@ +NAME + gcloud alpha container fleet policycontroller deployment - configure Policy + Controller component deployments + +SYNOPSIS + gcloud alpha container fleet policycontroller deployment COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Configure Policy Controller component deployments. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + remove + (ALPHA) Removes configuration properties from Policy Controller + components. + + set + (ALPHA) Sets configuration of the Policy Controller components. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta container fleet policycontroller deployment + diff --git a/gcloud/alpha/container/fleet/policycontroller/deployment/remove b/gcloud/alpha/container/fleet/policycontroller/deployment/remove new file mode 100644 index 000000000..84035d919 --- /dev/null +++ b/gcloud/alpha/container/fleet/policycontroller/deployment/remove @@ -0,0 +1,138 @@ +NAME + gcloud alpha container fleet policycontroller deployment remove - removes + configuration properties from Policy Controller components + +SYNOPSIS + gcloud alpha container fleet policycontroller deployment remove DEPLOYMENT + PROPERTY [VALUE] [--effect=EFFECT] + [--all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Remove customizations of on-cluster components in Policy + Controller. These components are managed as individual kubernetes + deployments (e.g. 'admission') in the gatekeeper-system namespace. + + When removing a 'toleration' property, it must match exactly, including the + key, value and effect flag (if originally specified). + +EXAMPLES + To remove the replica count for a component: + + $ gcloud alpha container fleet policycontroller deployment remove \ + admission replica-count + + To remove the replica count for a component across all fleet memberships: + + $ gcloud alpha container fleet policycontroller deployment remove \ + admission replica-count --all-memberships + + To remove a toleration with key 'my-key' on a component: + + $ gcloud alpha container fleet policycontroller deployment remove \ + admission toleration my-key + + To remove a toleration with key 'my-key' and 'my-value' on a component: + + $ gcloud alpha container fleet policycontroller deployment remove \ + admission toleration my-key=my-value + + To remove a toleration with key 'my-key' and 'my-value' on a component, + along with the effect 'NoSchedule': + + $ gcloud alpha container fleet policycontroller deployment remove \ + admission toleration my-key=my-value --effect=NoSchedule + + To remove a memory limit: + + $ gcloud alpha container fleet policycontroller deployment remove \ + audit memory-limit + + To remove a memory request: + + $ gcloud alpha container fleet policycontroller deployment remove \ + mutation memory-request + + To remove a cpu limit: + + $ gcloud alpha container fleet policycontroller deployment remove \ + admission cpu-limit + + To remove a cpu request: + + $ gcloud alpha container fleet policycontroller deployment remove \ + audit cpu-request + +POSITIONAL ARGUMENTS + DEPLOYMENT + The PolicyController deployment component (i.e, "admission", "audit" or + "mutation" from which to remove configuration. + + PROPERTY + Property to be removed. + + [VALUE] + This is only required to remove a toleration. It should not be included + for any other property. + +FLAGS + --effect=EFFECT + Applies only to "toleration" property. To be removed, tolerations must + match exactly, including the effect setting. EFFECT must be one of: + NoSchedule, PreferNoSchedule, NoExecute. + + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▸ provide the argument --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta container fleet policycontroller deployment remove + diff --git a/gcloud/alpha/container/fleet/policycontroller/deployment/set b/gcloud/alpha/container/fleet/policycontroller/deployment/set new file mode 100644 index 000000000..961102583 --- /dev/null +++ b/gcloud/alpha/container/fleet/policycontroller/deployment/set @@ -0,0 +1,145 @@ +NAME + gcloud alpha container fleet policycontroller deployment set - sets + configuration of the Policy Controller components + +SYNOPSIS + gcloud alpha container fleet policycontroller deployment set DEPLOYMENT + PROPERTY VALUE [--effect=EFFECT] + [--all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Customizes on-cluster components of Policy Controller. Supported + properties may be set with this command, or removed with 'remove'. These + components are managed as individual kubernetes deployments (e.g. + 'admission') in the gatekeeper-system namespace. + + When setting cpu or memory limits and requests, Kubernetes-standard + resource units are used. + + All properties set using this command will overwrite previous properties, + with the exception of tolerations which can only be added, and any number + may be added. To edit a toleration, use 'remove' to first delete it, and + then 'set' the desired toleration. + +EXAMPLES + To set the replica count for a component: + + $ gcloud alpha container fleet policycontroller deployment set \ + admission replica-count 3 + + To set the replica count for a component across all fleet memberships: + + $ gcloud alpha container fleet policycontroller deployment set \ + admission replica-count 3 --all-memberships + + To set a toleration with key 'my-key' on a component (which is an 'Exists' + operator): + + $ gcloud alpha container fleet policycontroller deployment set \ + admission toleration my-key + + To set a toleration with key 'my-key' and 'my-value' on a component (which + is an 'Equal' operator): + + $ gcloud alpha container fleet policycontroller deployment set \ + admission toleration my-key=my-value + + To set a toleration with key 'my-key' and 'my-value' on a component, along + with the effect 'NoSchedule' (which is an 'Equal' operator): + + $ gcloud alpha container fleet policycontroller deployment set \ + admission toleration my-key=my-value --effect=NoSchedule + + To set a memory limit: + + $ gcloud alpha container fleet policycontroller deployment set \ + audit memory-limit 4Gi + + To set a memory request: + + $ gcloud alpha container fleet policycontroller deployment set \ + mutation memory-request 2Gi + + To set a cpu limit: + + $ gcloud alpha container fleet policycontroller deployment set \ + admission cpu-limit 500m + + To set a cpu request: + + $ gcloud alpha container fleet policycontroller deployment set \ + audit cpu-request 250m + +POSITIONAL ARGUMENTS + DEPLOYMENT + The PolicyController deployment component (e.g. "admission", "audit" or + "mutation") upon which to set configuration. + + PROPERTY + Property to be set. + + VALUE + The value to set the property to. Valid input varies based on the + property being set. + +FLAGS + --effect=EFFECT + Applies only to "toleration" property. EFFECT must be one of: + NoSchedule, PreferNoSchedule, NoExecute. + + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▸ provide the argument --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta container fleet policycontroller deployment set + diff --git a/gcloud/alpha/container/fleet/policycontroller/describe b/gcloud/alpha/container/fleet/policycontroller/describe new file mode 100644 index 000000000..568f7067d --- /dev/null +++ b/gcloud/alpha/container/fleet/policycontroller/describe @@ -0,0 +1,70 @@ +NAME + gcloud alpha container fleet policycontroller describe - describe Policy + Controller feature + +SYNOPSIS + gcloud alpha container fleet policycontroller describe + [--all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [GCLOUD_WIDE_FLAG ...] + +EXAMPLES + To describe the Policy Controller feature: + + $ gcloud alpha container fleet policycontroller describe + +FLAGS + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▸ provide the argument --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta container fleet policycontroller describe + diff --git a/gcloud/alpha/container/fleet/policycontroller/detach b/gcloud/alpha/container/fleet/policycontroller/detach new file mode 100644 index 000000000..428739c36 --- /dev/null +++ b/gcloud/alpha/container/fleet/policycontroller/detach @@ -0,0 +1,80 @@ +NAME + gcloud alpha container fleet policycontroller detach - detach Policy + Controller Feature + +SYNOPSIS + gcloud alpha container fleet policycontroller detach + [--all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Detaches Policy Controller. This will halt all administration of + the Policy Controller installation by the GKE Fleet. It will not uninstall + it from the cluster. To re-attach Policy Controller, use the enable + command. + +EXAMPLES + To detach Policy Controller, run: + + $ gcloud alpha container fleet policycontroller detach + + To re-attach Policy Controller, use the enable command: + + $ gcloud alpha container fleet policycontroller enable + +FLAGS + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▸ provide the argument --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta container fleet policycontroller detach + diff --git a/gcloud/alpha/container/fleet/policycontroller/disable b/gcloud/alpha/container/fleet/policycontroller/disable new file mode 100644 index 000000000..3fdf35cbd --- /dev/null +++ b/gcloud/alpha/container/fleet/policycontroller/disable @@ -0,0 +1,83 @@ +NAME + gcloud alpha container fleet policycontroller disable - disable (Uninstall) + Policy Controller + +SYNOPSIS + gcloud alpha container fleet policycontroller disable + [--fleet-default-member-config | --all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Uninstalls Policy Controller. + +EXAMPLES + To uninstall Policy Controller, run: + + $ gcloud alpha container fleet policycontroller disable + +FLAGS + At most one of these can be specified: + + --fleet-default-member-config + Removes the fleet default configuration for policy controller. + Memberships configured with the fleet default will maintain their + current configuration. + + $ gcloud alpha container fleet policycontroller disable \ + --fleet-default-member-config + + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --project on the command line; + ▫ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ◇ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ◇ provide the argument --memberships on the command line with a + fully specified name; + ◇ provide the argument --location on the command line; + ◇ set the property gkehub/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta container fleet policycontroller disable + diff --git a/gcloud/alpha/container/fleet/policycontroller/enable b/gcloud/alpha/container/fleet/policycontroller/enable new file mode 100644 index 000000000..3a1218a4f --- /dev/null +++ b/gcloud/alpha/container/fleet/policycontroller/enable @@ -0,0 +1,181 @@ +NAME + gcloud alpha container fleet policycontroller enable - enable Policy + Controller Feature + +SYNOPSIS + gcloud alpha container fleet policycontroller enable + [--all-memberships | [--memberships=[MEMBERSHIPS,...] + : --location=LOCATION] --audit-interval=AUDIT_INTERVAL + --constraint-violation-limit=CONSTRAINT_VIOLATION_LIMIT + --no-default-bundles --version=VERSION --clear-exemptable-namespaces + | --exemptable-namespaces=EXEMPTABLE_NAMESPACES --log-denies + | --no-log-denies --monitoring=MONITORING + | --no-monitoring --mutation | --no-mutation --referential-rules + | --no-referential-rules + | --fleet-default-member-config=FLEET_DEFAULT_MEMBER_CONFIG + | --no-fleet-default-member-config] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Enables the Policy Controller Feature in a fleet. + +EXAMPLES + To enable the Policy Controller Feature, run: + + $ gcloud alpha container fleet policycontroller enable + +FLAGS + At most one of these can be specified: + + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --project on the command line; + ▫ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ◇ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ◇ provide the argument --memberships on the command line with a + fully specified name; + ◇ provide the argument --location on the command line; + ◇ set the property gkehub/location. + + --audit-interval=AUDIT_INTERVAL + How often Policy Controller will audit resources, in seconds. + + --constraint-violation-limit=CONSTRAINT_VIOLATION_LIMIT + The number of violations stored on the constraint resource. Must be + greater than 0. + + --no-default-bundles + If set, skip installing the default bundle of policy-essentials. + + --version=VERSION + The version of Policy Controller to install; defaults to latest + version. + + Exemptable Namespace flags. + + At most one of these can be specified: + + --clear-exemptable-namespaces + Removes any namespace exemptions, enabling Policy Controller on all + namespaces. Setting this flag will overwrite currently exempted + namespaces, not append. + + --exemptable-namespaces=EXEMPTABLE_NAMESPACES + Namespaces that Policy Controller should ignore, separated by + commas if multiple are supplied. + + Log Denies flags. + + At most one of these can be specified: + + --log-denies + If set, log all denies and dry run failures. (To disable, use + --no-log-denies) + + --no-log-denies + If set, disable all log denies. + + Monitoring flags. + + At most one of these can be specified: + + --monitoring=MONITORING + Monitoring backend options Policy Controller should export metrics + to, separated by commas if multiple are supplied. Setting this flag + will overwrite currently enabled backends, not append. Options: + prometheus, cloudmonitoring + + --no-monitoring + Include this flag to disable the monitoring configuration of Policy + Controller. + + Mutation flags. + + At most one of these can be specified: + + --mutation + If set, enable support for mutation. (To disable, use + --no-mutation) + + --no-mutation + Disables mutation support. + + Referential Rules flags. + + At most one of these can be specified: + + --referential-rules + If set, enable support for referential constraints. (To disable, + use --no-referential-rules) + + --no-referential-rules + Disables referential rules support. + + Flags for setting Fleet Default Configuration files. + + At most one of these can be specified: + + --fleet-default-member-config=FLEET_DEFAULT_MEMBER_CONFIG + The path to a policy-controller.yaml configuration file. If + specified, this configuration will become the default Policy + Controller configuration for all memberships in your fleet. It can + be overridden with a membership-specific configuration by using the + the Update command. + + To enable the Policy Controller Feature with a fleet-level default + membership configuration, run: + + $ gcloud alpha container fleet policycontroller enable \ + --fleet-default-member-config=/path/to/policy-controller.yaml + + --no-fleet-default-member-config + Removes the fleet default configuration for policy controller. + Memberships configured with the fleet default will maintain their + current configuration. + + $ gcloud alpha container fleet policycontroller enable \ + --no-fleet-default-member-config + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta container fleet policycontroller enable + diff --git a/gcloud/alpha/container/fleet/policycontroller/help b/gcloud/alpha/container/fleet/policycontroller/help index b6c7ff420..c91d4ef06 100644 --- a/gcloud/alpha/container/fleet/policycontroller/help +++ b/gcloud/alpha/container/fleet/policycontroller/help @@ -14,9 +14,41 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. +GROUPS + GROUP is one of the following: + + content + (ALPHA) Manage Policy Controller content. + + deployment + (ALPHA) Configure Policy Controller component deployments. + +COMMANDS + COMMAND is one of the following: + + describe + (ALPHA) Describe Policy Controller feature. + + detach + (ALPHA) Detach Policy Controller Feature. + + disable + (ALPHA) Disable (Uninstall) Policy Controller. + + enable + (ALPHA) Enable Policy Controller Feature. + + suspend + (ALPHA) Suspend Policy Controller Feature. + + update + (ALPHA) Updates the configuration of Policy Controller Feature. + NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta container fleet policycontroller diff --git a/gcloud/alpha/container/fleet/policycontroller/suspend b/gcloud/alpha/container/fleet/policycontroller/suspend new file mode 100644 index 000000000..23df0f4af --- /dev/null +++ b/gcloud/alpha/container/fleet/policycontroller/suspend @@ -0,0 +1,79 @@ +NAME + gcloud alpha container fleet policycontroller suspend - suspend Policy + Controller Feature + +SYNOPSIS + gcloud alpha container fleet policycontroller suspend + [--all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Suspends the Policy Controller. This will disable all kubernetes + webhooks on the configured cluster, thereby removing admission and mutation + functionality. Audit functionality will remain in place. + +EXAMPLES + To suspend Policy Controller, run: + + $ gcloud alpha container fleet policycontroller suspend + + To re-enable Policy Controller webhooks, use the enable command: + + $ gcloud alpha container fleet policycontroller enable + +FLAGS + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▸ provide the argument --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta container fleet policycontroller suspend + diff --git a/gcloud/alpha/container/fleet/policycontroller/update b/gcloud/alpha/container/fleet/policycontroller/update new file mode 100644 index 000000000..8e4ea35ac --- /dev/null +++ b/gcloud/alpha/container/fleet/policycontroller/update @@ -0,0 +1,164 @@ +NAME + gcloud alpha container fleet policycontroller update - updates the + configuration of Policy Controller Feature + +SYNOPSIS + gcloud alpha container fleet policycontroller update + [--all-memberships | [--memberships=[MEMBERSHIPS,...] + : --location=LOCATION] --origin=ORIGIN + | --audit-interval=AUDIT_INTERVAL + --constraint-violation-limit=CONSTRAINT_VIOLATION_LIMIT + --version=VERSION --clear-exemptable-namespaces + | --exemptable-namespaces=EXEMPTABLE_NAMESPACES --log-denies + | --no-log-denies --monitoring=MONITORING + | --no-monitoring --mutation | --no-mutation --referential-rules + | --no-referential-rules] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Updates the configuration of the Policy Controller installation + +EXAMPLES + To change the installed version, run: + + $ gcloud alpha container fleet policycontroller update \ + --version=VERSION + + To modify the audit interval to 120 seconds, run: + + $ gcloud alpha container fleet policycontroller update \ + --audit-interval=120 + +FLAGS + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▸ provide the argument --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. + + At most one of these can be specified: + + --origin=ORIGIN + If --origin=FLEET will set the configuration of the membership to the + fleet default. + + ORIGIN must be (only one value is supported): FLEET. + + --audit-interval=AUDIT_INTERVAL + How often Policy Controller will audit resources, in seconds. + + --constraint-violation-limit=CONSTRAINT_VIOLATION_LIMIT + The number of violations stored on the constraint resource. Must be + greater than 0. + + --version=VERSION + The version of Policy Controller to install; defaults to latest + version. + + Exemptable Namespace flags. + + At most one of these can be specified: + + --clear-exemptable-namespaces + Removes any namespace exemptions, enabling Policy Controller on all + namespaces. Setting this flag will overwrite currently exempted + namespaces, not append. + + --exemptable-namespaces=EXEMPTABLE_NAMESPACES + Namespaces that Policy Controller should ignore, separated by + commas if multiple are supplied. + + Log Denies flags. + + At most one of these can be specified: + + --log-denies + If set, log all denies and dry run failures. (To disable, use + --no-log-denies) + + --no-log-denies + If set, disable all log denies. + + Monitoring flags. + + At most one of these can be specified: + + --monitoring=MONITORING + Monitoring backend options Policy Controller should export metrics + to, separated by commas if multiple are supplied. Setting this flag + will overwrite currently enabled backends, not append. Options: + prometheus, cloudmonitoring + + --no-monitoring + Include this flag to disable the monitoring configuration of Policy + Controller. + + Mutation flags. + + At most one of these can be specified: + + --mutation + If set, enable support for mutation. (To disable, use + --no-mutation) + + --no-mutation + Disables mutation support. + + Referential Rules flags. + + At most one of these can be specified: + + --referential-rules + If set, enable support for referential constraints. (To disable, + use --no-referential-rules) + + --no-referential-rules + Disables referential rules support. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta container fleet policycontroller update + diff --git a/gcloud/alpha/container/hub/identity-service/apply b/gcloud/alpha/container/hub/identity-service/apply index 52f9597d0..99ebce912 100644 --- a/gcloud/alpha/container/hub/identity-service/apply +++ b/gcloud/alpha/container/hub/identity-service/apply @@ -3,8 +3,9 @@ NAME Service Feature Spec SYNOPSIS - gcloud alpha container hub identity-service apply --config=CONFIG - [--membership=MEMBERSHIP : --location=LOCATION] [GCLOUD_WIDE_FLAG ...] + gcloud alpha container hub identity-service apply + ([--config=CONFIG : [--membership=MEMBERSHIP : --location=LOCATION]]) + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Applies the authentication configuration to the Identity Service @@ -15,46 +16,50 @@ DESCRIPTION you run this command. EXAMPLES - To apply an Identity Service configuration for a membership, run: + To apply an Identity Service configuration to a membership, run: $ gcloud alpha container hub identity-service apply \ --membership=MEMBERSHIP_NAME \ --config=/path/to/identity-service.yaml REQUIRED FLAGS - --config=CONFIG - The path to the identity-service.yaml config file. + At least one of these must be specified: -OPTIONAL FLAGS - Membership resource - The group of arguments defining a membership. 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 --membership on the command line with a fully - specified name; - ◆ provide the argument --project on the command line; - ◆ set the property core/project. - - --membership=MEMBERSHIP - ID of the membership or fully qualified identifier for the - membership. - - To set the membership attribute: - ▸ provide the argument --membership on the command line. + --config=CONFIG + The path to an identity-service.yaml config file. This flag argument must be specified if any of the other arguments in this group are specified. - --location=LOCATION - Location for the membership. + Membership resource - The group of arguments defining a membership. 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 location attribute: - ▸ provide the argument --membership on the command line with a - fully specified name; - ▸ provide the argument --location on the command line; - ▸ set the property gkehub/location. + To set the project attribute: + ▸ provide the argument --membership on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --membership=MEMBERSHIP + ID of the membership or fully qualified identifier for the + membership. + + To set the membership attribute: + ▫ provide the argument --membership on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the membership. + + To set the location attribute: + ▫ provide the argument --membership on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/container/hub/policycontroller/content/bundles/help b/gcloud/alpha/container/hub/policycontroller/content/bundles/help new file mode 100644 index 000000000..d28ef27bc --- /dev/null +++ b/gcloud/alpha/container/hub/policycontroller/content/bundles/help @@ -0,0 +1,33 @@ +NAME + gcloud alpha container hub policycontroller content bundles - manage Policy + Controller content bundles + +SYNOPSIS + gcloud alpha container hub policycontroller content bundles COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Policy Controller content bundles. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + remove + (ALPHA) Removes a bundle installation for Policy Controller content. + + set + (ALPHA) Sets bundle installation for Policy Controller content. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta container hub policycontroller content bundles + diff --git a/gcloud/alpha/container/hub/policycontroller/content/bundles/remove b/gcloud/alpha/container/hub/policycontroller/content/bundles/remove new file mode 100644 index 000000000..58b602df8 --- /dev/null +++ b/gcloud/alpha/container/hub/policycontroller/content/bundles/remove @@ -0,0 +1,80 @@ +NAME + gcloud alpha container hub policycontroller content bundles remove - + removes a bundle installation for Policy Controller content + +SYNOPSIS + gcloud alpha container hub policycontroller content bundles remove + BUNDLE_NAME + [--all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Google-defined policy bundles of constraints can be installed onto + Policy Controller installations. This command removes those bundles. + +EXAMPLES + To remove a policy bundle: + + $ gcloud alpha container hub policycontroller content bundles \ + remove cis-k8s-v1.5.1 + +POSITIONAL ARGUMENTS + BUNDLE_NAME + The constraint bundle to remove from Policy Controller. + +FLAGS + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▸ provide the argument --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta container hub policycontroller content bundles remove + diff --git a/gcloud/alpha/container/hub/policycontroller/content/bundles/set b/gcloud/alpha/container/hub/policycontroller/content/bundles/set new file mode 100644 index 000000000..526dea487 --- /dev/null +++ b/gcloud/alpha/container/hub/policycontroller/content/bundles/set @@ -0,0 +1,111 @@ +NAME + gcloud alpha container hub policycontroller content bundles set - sets + bundle installation for Policy Controller content + +SYNOPSIS + gcloud alpha container hub policycontroller content bundles set BUNDLE_NAME + [--all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [--exempted-namespaces=EXEMPTED_NAMESPACES | --no-exempted-namespaces] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Google-defined policy bundles of constraints can be installed onto + Policy Controller installations. + + The namespace exclusion flag (--exempted-namespaces) will specify a set of + namespaces that the installed bundle will ignore. Subsequent calls with the + same bundle name and this flag will overwrite what namespaces are being + ignored. Using --no-exempted-namespaces or specifying no namespaces with + --exempted-namespaces will remove all namespaces from the ignore list. + + To uninstall a bundle, use the remove command. + +EXAMPLES + To install a policy bundle: + + $ gcloud alpha container hub policycontroller content bundles set \ + cis-k8s-v1.5.1 + + To install a policy bundle, while ignoring (exempting) certain namespaces + from being affected by the bundle: + + $ gcloud alpha container hub policycontroller content bundles set \ + cis-k8s-v1.5.1 \ + --exempted-namespaces=kube-system,gatekeeper-system + + To remove all exempted namespaces from a particular bundles ignore list: + + $ gcloud alpha container hub policycontroller content bundles set \ + cis-k8s-v1.5.1 --no-exempted-namespaces + +POSITIONAL ARGUMENTS + BUNDLE_NAME + The constraint bundle to install in Policy Controller. + +FLAGS + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▸ provide the argument --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. + + Exempted Namespaces flags. + + At most one of these can be specified: + + --exempted-namespaces=EXEMPTED_NAMESPACES + Exempted namespaces are ignored by Policy Controller when applying + constraints added by this bundle. + + --no-exempted-namespaces + Removes all exempted namespaces from the specified 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. This variant is also available: + + $ gcloud beta container hub policycontroller content bundles set + diff --git a/gcloud/alpha/container/hub/policycontroller/content/help b/gcloud/alpha/container/hub/policycontroller/content/help new file mode 100644 index 000000000..c7140a169 --- /dev/null +++ b/gcloud/alpha/container/hub/policycontroller/content/help @@ -0,0 +1,33 @@ +NAME + gcloud alpha container hub policycontroller content - manage Policy + Controller content + +SYNOPSIS + gcloud alpha container hub policycontroller content GROUP + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Policy Controller content. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + bundles + (ALPHA) Manage Policy Controller content bundles. + + templates + (ALPHA) Manage Policy Controller content templates. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta container hub policycontroller content + diff --git a/gcloud/alpha/container/hub/policycontroller/content/templates/disable b/gcloud/alpha/container/hub/policycontroller/content/templates/disable new file mode 100644 index 000000000..5d6c54104 --- /dev/null +++ b/gcloud/alpha/container/hub/policycontroller/content/templates/disable @@ -0,0 +1,76 @@ +NAME + gcloud alpha container hub policycontroller content templates disable - + disable template installation for Policy Controller content + +SYNOPSIS + gcloud alpha container hub policycontroller content templates disable + [--all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) The Google-defined template library can be installed onto Policy + Controller installations. This command removes that template library. + +EXAMPLES + To remove the template library: + + $ gcloud alpha container hub policycontroller content templates \ + disable + +FLAGS + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▸ provide the argument --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta container hub policycontroller content templates \ + disable + diff --git a/gcloud/alpha/container/hub/policycontroller/content/templates/enable b/gcloud/alpha/container/hub/policycontroller/content/templates/enable new file mode 100644 index 000000000..86f1cd794 --- /dev/null +++ b/gcloud/alpha/container/hub/policycontroller/content/templates/enable @@ -0,0 +1,76 @@ +NAME + gcloud alpha container hub policycontroller content templates enable - + installs the template library for Policy Controller + +SYNOPSIS + gcloud alpha container hub policycontroller content templates enable + [--all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Google-defined template library can be installed onto Policy + Controller installations. To uninstall the template library, use the + disable command. + +EXAMPLES + To install a template library: + + $ gcloud alpha container hub policycontroller content templates \ + enable + +FLAGS + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▸ provide the argument --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta container hub policycontroller content templates enable + diff --git a/gcloud/alpha/container/hub/policycontroller/content/templates/help b/gcloud/alpha/container/hub/policycontroller/content/templates/help new file mode 100644 index 000000000..aa7da4a89 --- /dev/null +++ b/gcloud/alpha/container/hub/policycontroller/content/templates/help @@ -0,0 +1,33 @@ +NAME + gcloud alpha container hub policycontroller content templates - manage + Policy Controller content templates + +SYNOPSIS + gcloud alpha container hub policycontroller content templates COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Policy Controller content templates. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + disable + (ALPHA) Disable template installation for Policy Controller content. + + enable + (ALPHA) Installs the template library for Policy Controller. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta container hub policycontroller content templates + diff --git a/gcloud/alpha/container/hub/policycontroller/deployment/help b/gcloud/alpha/container/hub/policycontroller/deployment/help new file mode 100644 index 000000000..3d96a1826 --- /dev/null +++ b/gcloud/alpha/container/hub/policycontroller/deployment/help @@ -0,0 +1,34 @@ +NAME + gcloud alpha container hub policycontroller deployment - configure Policy + Controller component deployments + +SYNOPSIS + gcloud alpha container hub policycontroller deployment COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Configure Policy Controller component deployments. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + remove + (ALPHA) Removes configuration properties from Policy Controller + components. + + set + (ALPHA) Sets configuration of the Policy Controller components. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta container hub policycontroller deployment + diff --git a/gcloud/alpha/container/hub/policycontroller/deployment/remove b/gcloud/alpha/container/hub/policycontroller/deployment/remove new file mode 100644 index 000000000..3b8ffe7c7 --- /dev/null +++ b/gcloud/alpha/container/hub/policycontroller/deployment/remove @@ -0,0 +1,138 @@ +NAME + gcloud alpha container hub policycontroller deployment remove - removes + configuration properties from Policy Controller components + +SYNOPSIS + gcloud alpha container hub policycontroller deployment remove DEPLOYMENT + PROPERTY [VALUE] [--effect=EFFECT] + [--all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Remove customizations of on-cluster components in Policy + Controller. These components are managed as individual kubernetes + deployments (e.g. 'admission') in the gatekeeper-system namespace. + + When removing a 'toleration' property, it must match exactly, including the + key, value and effect flag (if originally specified). + +EXAMPLES + To remove the replica count for a component: + + $ gcloud alpha container hub policycontroller deployment remove \ + admission replica-count + + To remove the replica count for a component across all fleet memberships: + + $ gcloud alpha container hub policycontroller deployment remove \ + admission replica-count --all-memberships + + To remove a toleration with key 'my-key' on a component: + + $ gcloud alpha container hub policycontroller deployment remove \ + admission toleration my-key + + To remove a toleration with key 'my-key' and 'my-value' on a component: + + $ gcloud alpha container hub policycontroller deployment remove \ + admission toleration my-key=my-value + + To remove a toleration with key 'my-key' and 'my-value' on a component, + along with the effect 'NoSchedule': + + $ gcloud alpha container hub policycontroller deployment remove \ + admission toleration my-key=my-value --effect=NoSchedule + + To remove a memory limit: + + $ gcloud alpha container hub policycontroller deployment remove \ + audit memory-limit + + To remove a memory request: + + $ gcloud alpha container hub policycontroller deployment remove \ + mutation memory-request + + To remove a cpu limit: + + $ gcloud alpha container hub policycontroller deployment remove \ + admission cpu-limit + + To remove a cpu request: + + $ gcloud alpha container hub policycontroller deployment remove \ + audit cpu-request + +POSITIONAL ARGUMENTS + DEPLOYMENT + The PolicyController deployment component (i.e, "admission", "audit" or + "mutation" from which to remove configuration. + + PROPERTY + Property to be removed. + + [VALUE] + This is only required to remove a toleration. It should not be included + for any other property. + +FLAGS + --effect=EFFECT + Applies only to "toleration" property. To be removed, tolerations must + match exactly, including the effect setting. EFFECT must be one of: + NoSchedule, PreferNoSchedule, NoExecute. + + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▸ provide the argument --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta container hub policycontroller deployment remove + diff --git a/gcloud/alpha/container/hub/policycontroller/deployment/set b/gcloud/alpha/container/hub/policycontroller/deployment/set new file mode 100644 index 000000000..0d73ac2e9 --- /dev/null +++ b/gcloud/alpha/container/hub/policycontroller/deployment/set @@ -0,0 +1,145 @@ +NAME + gcloud alpha container hub policycontroller deployment set - sets + configuration of the Policy Controller components + +SYNOPSIS + gcloud alpha container hub policycontroller deployment set DEPLOYMENT + PROPERTY VALUE [--effect=EFFECT] + [--all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Customizes on-cluster components of Policy Controller. Supported + properties may be set with this command, or removed with 'remove'. These + components are managed as individual kubernetes deployments (e.g. + 'admission') in the gatekeeper-system namespace. + + When setting cpu or memory limits and requests, Kubernetes-standard + resource units are used. + + All properties set using this command will overwrite previous properties, + with the exception of tolerations which can only be added, and any number + may be added. To edit a toleration, use 'remove' to first delete it, and + then 'set' the desired toleration. + +EXAMPLES + To set the replica count for a component: + + $ gcloud alpha container hub policycontroller deployment set \ + admission replica-count 3 + + To set the replica count for a component across all fleet memberships: + + $ gcloud alpha container hub policycontroller deployment set \ + admission replica-count 3 --all-memberships + + To set a toleration with key 'my-key' on a component (which is an 'Exists' + operator): + + $ gcloud alpha container hub policycontroller deployment set \ + admission toleration my-key + + To set a toleration with key 'my-key' and 'my-value' on a component (which + is an 'Equal' operator): + + $ gcloud alpha container hub policycontroller deployment set \ + admission toleration my-key=my-value + + To set a toleration with key 'my-key' and 'my-value' on a component, along + with the effect 'NoSchedule' (which is an 'Equal' operator): + + $ gcloud alpha container hub policycontroller deployment set \ + admission toleration my-key=my-value --effect=NoSchedule + + To set a memory limit: + + $ gcloud alpha container hub policycontroller deployment set audit \ + memory-limit 4Gi + + To set a memory request: + + $ gcloud alpha container hub policycontroller deployment set \ + mutation memory-request 2Gi + + To set a cpu limit: + + $ gcloud alpha container hub policycontroller deployment set \ + admission cpu-limit 500m + + To set a cpu request: + + $ gcloud alpha container hub policycontroller deployment set audit \ + cpu-request 250m + +POSITIONAL ARGUMENTS + DEPLOYMENT + The PolicyController deployment component (e.g. "admission", "audit" or + "mutation") upon which to set configuration. + + PROPERTY + Property to be set. + + VALUE + The value to set the property to. Valid input varies based on the + property being set. + +FLAGS + --effect=EFFECT + Applies only to "toleration" property. EFFECT must be one of: + NoSchedule, PreferNoSchedule, NoExecute. + + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▸ provide the argument --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta container hub policycontroller deployment set + diff --git a/gcloud/alpha/container/hub/policycontroller/describe b/gcloud/alpha/container/hub/policycontroller/describe new file mode 100644 index 000000000..7c785237a --- /dev/null +++ b/gcloud/alpha/container/hub/policycontroller/describe @@ -0,0 +1,70 @@ +NAME + gcloud alpha container hub policycontroller describe - describe Policy + Controller feature + +SYNOPSIS + gcloud alpha container hub policycontroller describe + [--all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [GCLOUD_WIDE_FLAG ...] + +EXAMPLES + To describe the Policy Controller feature: + + $ gcloud alpha container hub policycontroller describe + +FLAGS + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▸ provide the argument --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta container hub policycontroller describe + diff --git a/gcloud/alpha/container/hub/policycontroller/detach b/gcloud/alpha/container/hub/policycontroller/detach new file mode 100644 index 000000000..7f7440a9e --- /dev/null +++ b/gcloud/alpha/container/hub/policycontroller/detach @@ -0,0 +1,80 @@ +NAME + gcloud alpha container hub policycontroller detach - detach Policy + Controller Feature + +SYNOPSIS + gcloud alpha container hub policycontroller detach + [--all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Detaches Policy Controller. This will halt all administration of + the Policy Controller installation by the GKE Fleet. It will not uninstall + it from the cluster. To re-attach Policy Controller, use the enable + command. + +EXAMPLES + To detach Policy Controller, run: + + $ gcloud alpha container hub policycontroller detach + + To re-attach Policy Controller, use the enable command: + + $ gcloud alpha container hub policycontroller enable + +FLAGS + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▸ provide the argument --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta container hub policycontroller detach + diff --git a/gcloud/alpha/container/hub/policycontroller/disable b/gcloud/alpha/container/hub/policycontroller/disable new file mode 100644 index 000000000..041512d79 --- /dev/null +++ b/gcloud/alpha/container/hub/policycontroller/disable @@ -0,0 +1,83 @@ +NAME + gcloud alpha container hub policycontroller disable - disable (Uninstall) + Policy Controller + +SYNOPSIS + gcloud alpha container hub policycontroller disable + [--fleet-default-member-config | --all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Uninstalls Policy Controller. + +EXAMPLES + To uninstall Policy Controller, run: + + $ gcloud alpha container hub policycontroller disable + +FLAGS + At most one of these can be specified: + + --fleet-default-member-config + Removes the fleet default configuration for policy controller. + Memberships configured with the fleet default will maintain their + current configuration. + + $ gcloud alpha container hub policycontroller disable \ + --fleet-default-member-config + + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --project on the command line; + ▫ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ◇ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ◇ provide the argument --memberships on the command line with a + fully specified name; + ◇ provide the argument --location on the command line; + ◇ set the property gkehub/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta container hub policycontroller disable + diff --git a/gcloud/alpha/container/hub/policycontroller/enable b/gcloud/alpha/container/hub/policycontroller/enable new file mode 100644 index 000000000..6902bc1dc --- /dev/null +++ b/gcloud/alpha/container/hub/policycontroller/enable @@ -0,0 +1,181 @@ +NAME + gcloud alpha container hub policycontroller enable - enable Policy + Controller Feature + +SYNOPSIS + gcloud alpha container hub policycontroller enable + [--all-memberships | [--memberships=[MEMBERSHIPS,...] + : --location=LOCATION] --audit-interval=AUDIT_INTERVAL + --constraint-violation-limit=CONSTRAINT_VIOLATION_LIMIT + --no-default-bundles --version=VERSION --clear-exemptable-namespaces + | --exemptable-namespaces=EXEMPTABLE_NAMESPACES --log-denies + | --no-log-denies --monitoring=MONITORING + | --no-monitoring --mutation | --no-mutation --referential-rules + | --no-referential-rules + | --fleet-default-member-config=FLEET_DEFAULT_MEMBER_CONFIG + | --no-fleet-default-member-config] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Enables the Policy Controller Feature in a fleet. + +EXAMPLES + To enable the Policy Controller Feature, run: + + $ gcloud alpha container hub policycontroller enable + +FLAGS + At most one of these can be specified: + + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --project on the command line; + ▫ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ◇ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ◇ provide the argument --memberships on the command line with a + fully specified name; + ◇ provide the argument --location on the command line; + ◇ set the property gkehub/location. + + --audit-interval=AUDIT_INTERVAL + How often Policy Controller will audit resources, in seconds. + + --constraint-violation-limit=CONSTRAINT_VIOLATION_LIMIT + The number of violations stored on the constraint resource. Must be + greater than 0. + + --no-default-bundles + If set, skip installing the default bundle of policy-essentials. + + --version=VERSION + The version of Policy Controller to install; defaults to latest + version. + + Exemptable Namespace flags. + + At most one of these can be specified: + + --clear-exemptable-namespaces + Removes any namespace exemptions, enabling Policy Controller on all + namespaces. Setting this flag will overwrite currently exempted + namespaces, not append. + + --exemptable-namespaces=EXEMPTABLE_NAMESPACES + Namespaces that Policy Controller should ignore, separated by + commas if multiple are supplied. + + Log Denies flags. + + At most one of these can be specified: + + --log-denies + If set, log all denies and dry run failures. (To disable, use + --no-log-denies) + + --no-log-denies + If set, disable all log denies. + + Monitoring flags. + + At most one of these can be specified: + + --monitoring=MONITORING + Monitoring backend options Policy Controller should export metrics + to, separated by commas if multiple are supplied. Setting this flag + will overwrite currently enabled backends, not append. Options: + prometheus, cloudmonitoring + + --no-monitoring + Include this flag to disable the monitoring configuration of Policy + Controller. + + Mutation flags. + + At most one of these can be specified: + + --mutation + If set, enable support for mutation. (To disable, use + --no-mutation) + + --no-mutation + Disables mutation support. + + Referential Rules flags. + + At most one of these can be specified: + + --referential-rules + If set, enable support for referential constraints. (To disable, + use --no-referential-rules) + + --no-referential-rules + Disables referential rules support. + + Flags for setting Fleet Default Configuration files. + + At most one of these can be specified: + + --fleet-default-member-config=FLEET_DEFAULT_MEMBER_CONFIG + The path to a policy-controller.yaml configuration file. If + specified, this configuration will become the default Policy + Controller configuration for all memberships in your fleet. It can + be overridden with a membership-specific configuration by using the + the Update command. + + To enable the Policy Controller Feature with a fleet-level default + membership configuration, run: + + $ gcloud alpha container hub policycontroller enable \ + --fleet-default-member-config=/path/to/policy-controller.yaml + + --no-fleet-default-member-config + Removes the fleet default configuration for policy controller. + Memberships configured with the fleet default will maintain their + current configuration. + + $ gcloud alpha container hub policycontroller enable \ + --no-fleet-default-member-config + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta container hub policycontroller enable + diff --git a/gcloud/alpha/container/hub/policycontroller/help b/gcloud/alpha/container/hub/policycontroller/help index 446786e89..bf486487a 100644 --- a/gcloud/alpha/container/hub/policycontroller/help +++ b/gcloud/alpha/container/hub/policycontroller/help @@ -14,9 +14,41 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. +GROUPS + GROUP is one of the following: + + content + (ALPHA) Manage Policy Controller content. + + deployment + (ALPHA) Configure Policy Controller component deployments. + +COMMANDS + COMMAND is one of the following: + + describe + (ALPHA) Describe Policy Controller feature. + + detach + (ALPHA) Detach Policy Controller Feature. + + disable + (ALPHA) Disable (Uninstall) Policy Controller. + + enable + (ALPHA) Enable Policy Controller Feature. + + suspend + (ALPHA) Suspend Policy Controller Feature. + + update + (ALPHA) Updates the configuration of Policy Controller Feature. + NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta container hub policycontroller diff --git a/gcloud/alpha/container/hub/policycontroller/suspend b/gcloud/alpha/container/hub/policycontroller/suspend new file mode 100644 index 000000000..d0eb478bc --- /dev/null +++ b/gcloud/alpha/container/hub/policycontroller/suspend @@ -0,0 +1,79 @@ +NAME + gcloud alpha container hub policycontroller suspend - suspend Policy + Controller Feature + +SYNOPSIS + gcloud alpha container hub policycontroller suspend + [--all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Suspends the Policy Controller. This will disable all kubernetes + webhooks on the configured cluster, thereby removing admission and mutation + functionality. Audit functionality will remain in place. + +EXAMPLES + To suspend Policy Controller, run: + + $ gcloud alpha container hub policycontroller suspend + + To re-enable Policy Controller webhooks, use the enable command: + + $ gcloud alpha container hub policycontroller enable + +FLAGS + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▸ provide the argument --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta container hub policycontroller suspend + diff --git a/gcloud/alpha/container/hub/policycontroller/update b/gcloud/alpha/container/hub/policycontroller/update new file mode 100644 index 000000000..2abc217e5 --- /dev/null +++ b/gcloud/alpha/container/hub/policycontroller/update @@ -0,0 +1,164 @@ +NAME + gcloud alpha container hub policycontroller update - updates the + configuration of Policy Controller Feature + +SYNOPSIS + gcloud alpha container hub policycontroller update + [--all-memberships | [--memberships=[MEMBERSHIPS,...] + : --location=LOCATION] --origin=ORIGIN + | --audit-interval=AUDIT_INTERVAL + --constraint-violation-limit=CONSTRAINT_VIOLATION_LIMIT + --version=VERSION --clear-exemptable-namespaces + | --exemptable-namespaces=EXEMPTABLE_NAMESPACES --log-denies + | --no-log-denies --monitoring=MONITORING + | --no-monitoring --mutation | --no-mutation --referential-rules + | --no-referential-rules] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Updates the configuration of the Policy Controller installation + +EXAMPLES + To change the installed version, run: + + $ gcloud alpha container hub policycontroller update \ + --version=VERSION + + To modify the audit interval to 120 seconds, run: + + $ gcloud alpha container hub policycontroller update \ + --audit-interval=120 + +FLAGS + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▸ provide the argument --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. + + At most one of these can be specified: + + --origin=ORIGIN + If --origin=FLEET will set the configuration of the membership to the + fleet default. + + ORIGIN must be (only one value is supported): FLEET. + + --audit-interval=AUDIT_INTERVAL + How often Policy Controller will audit resources, in seconds. + + --constraint-violation-limit=CONSTRAINT_VIOLATION_LIMIT + The number of violations stored on the constraint resource. Must be + greater than 0. + + --version=VERSION + The version of Policy Controller to install; defaults to latest + version. + + Exemptable Namespace flags. + + At most one of these can be specified: + + --clear-exemptable-namespaces + Removes any namespace exemptions, enabling Policy Controller on all + namespaces. Setting this flag will overwrite currently exempted + namespaces, not append. + + --exemptable-namespaces=EXEMPTABLE_NAMESPACES + Namespaces that Policy Controller should ignore, separated by + commas if multiple are supplied. + + Log Denies flags. + + At most one of these can be specified: + + --log-denies + If set, log all denies and dry run failures. (To disable, use + --no-log-denies) + + --no-log-denies + If set, disable all log denies. + + Monitoring flags. + + At most one of these can be specified: + + --monitoring=MONITORING + Monitoring backend options Policy Controller should export metrics + to, separated by commas if multiple are supplied. Setting this flag + will overwrite currently enabled backends, not append. Options: + prometheus, cloudmonitoring + + --no-monitoring + Include this flag to disable the monitoring configuration of Policy + Controller. + + Mutation flags. + + At most one of these can be specified: + + --mutation + If set, enable support for mutation. (To disable, use + --no-mutation) + + --no-mutation + Disables mutation support. + + Referential Rules flags. + + At most one of these can be specified: + + --referential-rules + If set, enable support for referential constraints. (To disable, + use --no-referential-rules) + + --no-referential-rules + Disables referential rules support. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta container hub policycontroller update + diff --git a/gcloud/alpha/dataplex/datascan/create b/gcloud/alpha/dataplex/datascan/create deleted file mode 100644 index f65165ca2..000000000 --- a/gcloud/alpha/dataplex/datascan/create +++ /dev/null @@ -1,159 +0,0 @@ -NAME - gcloud alpha dataplex datascan create - create a Dataplex Datascan - -SYNOPSIS - gcloud alpha dataplex datascan create (DATASCAN : --location=LOCATION) - --scan-type=SCAN_TYPE - (--data-source-entity=DATA_SOURCE_ENTITY - | --data-source-resource=DATA_SOURCE_RESOURCE) - [--description=DESCRIPTION] [--display-name=DISPLAY_NAME] - [--labels=[KEY=VALUE,...]] [--async | --validate-only] - [--data-profile-spec-file=DATA_PROFILE_SPEC_FILE - | --data-quality-spec-file=DATA_QUALITY_SPEC_FILE] - [--field=FIELD --on-demand=ON_DEMAND --schedule=SCHEDULE] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) (DEPRECATED) Create a Dataplex Datascan. - - This command is deprecated. Please use gcloud alpha dataplex datascans - create data-profile instead to create a data profile scan and use gcloud - alpha dataplex datascans create data-quality to create a data quality scan. - -EXAMPLES - Create a Dataplex datascan job. - - Represents a user-visible job which provides the insights for the related - data source. For example: - ▪ Data Quality: generates queries based on the rules and run against - the data to get data quality check results. - ▪ Data Profile: analyzes the data in table(s) and generates insights - about the structure, content and relationships (such as null percent, - cardinality, min/max/mean, etc). - -POSITIONAL ARGUMENTS - Datascan resource - Arguments and flags that define the Dataplex datascan - you want to create a Datascan for. The arguments in this group can be used - to specify the attributes of this resource. (NOTE) Some attributes are not - given arguments in this group but can be set in other ways. - - To set the project attribute: - ◆ provide the argument datascan 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. - - DATASCAN - ID of the datascan or fully qualified identifier for the datascan. - - To set the dataScans attribute: - ▸ provide the argument datascan 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 of the Dataplex resource. - - To set the location attribute: - ▸ provide the argument datascan on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property dataplex/location. - -REQUIRED FLAGS - --scan-type=SCAN_TYPE - Specify the type of scan. SCAN_TYPE must be one of: PROFILE, QUALITY. - - Data source for the Datascan. - - Exactly one of these must be specified: - - --data-source-entity=DATA_SOURCE_ENTITY - Dataplex entity that contains the data for the Datascan, of the form: - projects/{project_number}/locations/{location_id}/lakes/{lake_id}/zones/{zone_id}/entities/{entity_id}. - - --data-source-resource=DATA_SOURCE_RESOURCE - Service-qualified full resource name of the cloud resource that - contains the data for the Datascan, of the form: - //bigquery.googleapis.com/projects/{project_number}/datasets/{dataset_id}/tables/{table_id}. - -OPTIONAL FLAGS - --description=DESCRIPTION - Description of the Datascan - - --display-name=DISPLAY_NAME - Display name of the Datascan - - --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. - - At most one of --async | --validate-only can be specified. - - At most one of these can be specified: - - --async - Return immediately, without waiting for the operation in progress to - complete. - - --validate-only - Validate the create action, but don't actually perform it. - - Additional configuration arguments for the scan. - - At most one of these can be specified: - - DataProfileScan related setting. - - --data-profile-spec-file=DATA_PROFILE_SPEC_FILE - path to the JSON file containing the Data Profile Spec for the Data - Profile Scan - - DataQualityScan related setting. - - --data-quality-spec-file=DATA_QUALITY_SPEC_FILE - path to the JSON file containing the Data Quality Spec for the Data - Quality Scan - - Datascan execution settings. If not specified, the fields under it will - use their default values. - - --field=FIELD - Field that contains values that monotonically increase over time - (e.g. timestamp). - - Datascan scheduling and trigger settings - - --on-demand=ON_DEMAND - If set, the scan runs one-time shortly after Datascan Creation. - - --schedule=SCHEDULE - Cron schedule (https://en.wikipedia.org/wiki/Cron) for running - scans periodically. To explicitly set a timezone to the cron tab, - apply a prefix in the cron tab: "CRON_TZ=${IANA_TIME_ZONE}" or - "TZ=${IANA_TIME_ZONE}". The ${IANA_TIME_ZONE} may only be a valid - string from IANA time zone database. For example, - CRON_TZ=America/New_York 1 * * * * or TZ=America/New_York 1 * * * - *. This field is required for RECURRING scans. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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/datascan/delete b/gcloud/alpha/dataplex/datascan/delete deleted file mode 100644 index 8308a926f..000000000 --- a/gcloud/alpha/dataplex/datascan/delete +++ /dev/null @@ -1,74 +0,0 @@ -NAME - gcloud alpha dataplex datascan delete - delete a Dataplex Datascan resource - -SYNOPSIS - gcloud alpha dataplex datascan delete (DATASCAN : --location=LOCATION) - [--async] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) (DEPRECATED) This command is deprecated. Please use gcloud alpha - dataplex datascans instead. - - Delete a Dataplex Datascan resource. - -EXAMPLES - To delete a Dataplex Datascan test-datascan in location us-central1, run: - - $ gcloud alpha dataplex datascan delete test-datascan \ - --location=us-central1 - -POSITIONAL ARGUMENTS - Datascan resource - Arguments and flags that define the Dataplex Datascan - you want to delete. The arguments in this group can be used to specify the - attributes of this resource. (NOTE) Some attributes are not given - arguments in this group but can be set in other ways. - - To set the project attribute: - ◆ provide the argument datascan 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. - - DATASCAN - ID of the datascan or fully qualified identifier for the datascan. - - To set the datascan attribute: - ▸ provide the argument datascan 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 Dataplex resource. - - To set the location attribute: - ▸ provide the argument datascan on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property dataplex/location. - -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 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. - diff --git a/gcloud/alpha/dataplex/datascan/describe b/gcloud/alpha/dataplex/datascan/describe deleted file mode 100644 index 2381fd466..000000000 --- a/gcloud/alpha/dataplex/datascan/describe +++ /dev/null @@ -1,71 +0,0 @@ -NAME - gcloud alpha dataplex datascan describe - describe a Dataplex lake resource - -SYNOPSIS - gcloud alpha dataplex datascan describe (DATASCAN : --location=LOCATION) - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) (DEPRECATED) This command is deprecated. Please use gcloud alpha - dataplex datascans instead. - - Displays all details of a Dataplex Datascan resource given a valid Datascan - ID. - -EXAMPLES - To describe a Dataplex Datascan test-datascan in project test-project - location us-central1 , run: - - $ gcloud alpha dataplex datascan describe test-datascan \ - --project=test-project --location=us-central1 - -POSITIONAL ARGUMENTS - Datascan resource - Arguments and flags that define the Dataplex Datascan - you want to retrieve. 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 datascan 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. - - DATASCAN - ID of the datascan or fully qualified identifier for the datascan. - - To set the datascan attribute: - ▸ provide the argument datascan 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 Dataplex resource. - - To set the location attribute: - ▸ provide the argument datascan on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property dataplex/location. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -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. - diff --git a/gcloud/alpha/dataplex/datascan/help b/gcloud/alpha/dataplex/datascan/help deleted file mode 100644 index f7afcdaec..000000000 --- a/gcloud/alpha/dataplex/datascan/help +++ /dev/null @@ -1,47 +0,0 @@ -NAME - gcloud alpha dataplex datascan - manage Dataplex Datascan - -SYNOPSIS - gcloud alpha dataplex datascan GROUP | COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) (DEPRECATED) Manage Dataplex Datascan. - - This command is deprecated. Please use gcloud alpha dataplex datascans - instead. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -GROUPS - GROUP is one of the following: - - jobs - (ALPHA) (DEPRECATED) Manage Dataplex Datascan Jobs services. - -COMMANDS - COMMAND is one of the following: - - create - (ALPHA) (DEPRECATED) Create a Dataplex Datascan. - - delete - (ALPHA) (DEPRECATED) Delete a Dataplex Datascan resource. - - describe - (ALPHA) (DEPRECATED) Describe a Dataplex lake resource. - - list - (ALPHA) (DEPRECATED) List Dataplex Datascan resources under a project. - - run - (ALPHA) (DEPRECATED) Run a Dataplex DataScan resource. - -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/datascan/jobs/describe b/gcloud/alpha/dataplex/datascan/jobs/describe deleted file mode 100644 index ed87dcee7..000000000 --- a/gcloud/alpha/dataplex/datascan/jobs/describe +++ /dev/null @@ -1,99 +0,0 @@ -NAME - gcloud alpha dataplex datascan jobs describe - describe a Dataplex job - running a particular datascan - -SYNOPSIS - gcloud alpha dataplex datascan jobs describe - (JOB : --datascan=DATASCAN --location=LOCATION) [--view=VIEW] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) (DEPRECATED) This command is deprecated. Please use gcloud alpha - dataplex datascans jobs instead. - - Describe a Dataplex job running a particular datascan. - - Displays all details of a Dataplex job given a valid job ID. - -EXAMPLES - To describe a Dataplex job test-job running a datascan test-datascan in - location us-central1, run: - - $ gcloud alpha dataplex datascan jobs describe test-job \ - --location=us-central1 --datascan=test-datascan - - To describe the details of Dataplex job test-job running a datascan - test-datascan in location us-central1, run: - - $ gcloud alpha dataplex datascan jobs describe test-job \ - --location=us-central1 --datascan=test-datascan --view=FULL - -POSITIONAL ARGUMENTS - Job resource - Arguments and flags that define the Dataplex Job running a - particular Datascan you want to retrieve. 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 job 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. - - JOB - ID of the job or fully qualified identifier for the job. - - To set the job attribute: - ▸ provide the argument job on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --datascan=DATASCAN - Datascan ID of the Dataplex datascan resource. - - To set the datascan attribute: - ▸ provide the argument job on the command line with a fully - specified name; - ▸ provide the argument --datascan on the command line. - - --location=LOCATION - Location of the Dataplex resource. - - To set the location attribute: - ▸ provide the argument job on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property dataplex/location. - -FLAGS - --view=VIEW - There are two possible views: 'basic' and 'full'. The default view is - 'basic'. VIEW must be one of: - - basic - Does not include spec and result data in response. - - full - Includes spec and result data in response. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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. - diff --git a/gcloud/alpha/dataplex/datascan/jobs/help b/gcloud/alpha/dataplex/datascan/jobs/help deleted file mode 100644 index dd2d1c3f9..000000000 --- a/gcloud/alpha/dataplex/datascan/jobs/help +++ /dev/null @@ -1,34 +0,0 @@ -NAME - gcloud alpha dataplex datascan jobs - manage Dataplex Datascan Jobs - services - -SYNOPSIS - gcloud alpha dataplex datascan jobs COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) (DEPRECATED) Manage Dataplex Datascan Jobs services. - - This command is deprecated. Please use gcloud alpha dataplex datascans jobs - instead. - -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) (DEPRECATED) Describe a Dataplex job running a particular - datascan. - - list - (ALPHA) (DEPRECATED) List job runs of a Dataplex datascan resource. - -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/datascan/jobs/list b/gcloud/alpha/dataplex/datascan/jobs/list deleted file mode 100644 index 7318a9af6..000000000 --- a/gcloud/alpha/dataplex/datascan/jobs/list +++ /dev/null @@ -1,104 +0,0 @@ -NAME - gcloud alpha dataplex datascan jobs list - list job runs of a Dataplex - datascan resource - -SYNOPSIS - gcloud alpha dataplex datascan jobs list - (--datascan=DATASCAN : --location=LOCATION) [--filter=EXPRESSION] - [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) (DEPRECATED) This command is deprecated. Please use gcloud alpha - dataplex datascans jobs instead. - - List Jobs runs of a Datascan under a specific project, location and task. - -EXAMPLES - To list all the Dataplex job runs for a datascan test-datascan in location - us-central1, run: - - gcloud alpha dataplex datascan jobs list --location=us-central1 --datascan=test-datascan - -REQUIRED FLAGS - Datascan resource - Arguments and flags that define the Dataplex Datascan - to list the Jobs running the Datascan. 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 --datascan 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. - - --datascan=DATASCAN - ID of the datascan or fully qualified identifier for the datascan. - - To set the datascan attribute: - ▸ provide the argument --datascan on the command line. - - This flag argument must be specified if any of the other arguments in - this group are specified. - - --location=LOCATION - Location of the Dataplex resource. - - To set the location attribute: - ▸ provide the argument --datascan on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property dataplex/location. - -LIST COMMAND FLAGS - --filter=EXPRESSION - Apply a Boolean filter EXPRESSION to each resource item to be listed. - If the expression evaluates True, then that item is listed. For more - details and examples of filter expressions, run $ gcloud topic filters. - This flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --limit=LIMIT - Maximum number of resources to list. The default is unlimited. This - flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --page-size=PAGE_SIZE - Some services group resource list output into pages. This flag - specifies the maximum number of resources per page. The default is - determined by the service if it supports paging, otherwise it is - unlimited (no paging). Paging may be applied before or after --filter - and --limit depending on the service. - - --sort-by=[FIELD,...] - Comma-separated list of resource field key names to sort by. The - default order is ascending. Prefix a field with ``~'' for descending - order on that field. This flag interacts with other flags that are - applied in this order: --flatten, --sort-by, --filter, --limit. - - --uri - Print a list of resource URIs instead of the default output, and change - the command output to a list of URIs. If this flag is used with - --format, the formatting is applied on this URI list. To display URIs - alongside other keys instead, use the uri() transform. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the 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. - diff --git a/gcloud/alpha/dataplex/datascan/list b/gcloud/alpha/dataplex/datascan/list deleted file mode 100644 index fc7c48832..000000000 --- a/gcloud/alpha/dataplex/datascan/list +++ /dev/null @@ -1,96 +0,0 @@ -NAME - gcloud alpha dataplex datascan list - list Dataplex Datascan resources - under a project - -SYNOPSIS - gcloud alpha dataplex datascan list [--location=LOCATION] - [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] - [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) (DEPRECATED) This command is deprecated. Please use gcloud alpha - dataplex datascans instead. - - List all Dataplex Datascan resource under a specific project and location. - -EXAMPLES - To list all Dataplex Datascan resources in project=test-project in location - us-central, run: - - $ gcloud alpha dataplex datascan list --project=test-project \ - --location=us-central1 - - To list all Dataplex Datascan in all locations, run: - - $ gcloud alpha dataplex datascan list --project=test-project \ - --location=- - -FLAGS - Location resource - Arguments and flags that define the Dataplex Datascan - you want to list. 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 dataplex/location 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; - ▸ set the property dataplex/location. - -LIST COMMAND FLAGS - --filter=EXPRESSION - Apply a Boolean filter EXPRESSION to each resource item to be listed. - If the expression evaluates True, then that item is listed. For more - details and examples of filter expressions, run $ gcloud topic filters. - This flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --limit=LIMIT - Maximum number of resources to list. The default is unlimited. This - flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --page-size=PAGE_SIZE - Some services group resource list output into pages. This flag - specifies the maximum number of resources per page. The default is - determined by the service if it supports paging, otherwise it is - unlimited (no paging). Paging may be applied before or after --filter - and --limit depending on the service. - - --sort-by=[FIELD,...] - Comma-separated list of resource field key names to sort by. The - default order is ascending. Prefix a field with ``~'' for descending - order on that field. This flag interacts with other flags that are - applied in this order: --flatten, --sort-by, --filter, --limit. - - --uri - Print a list of resource URIs instead of the default output, and change - the command output to a list of URIs. If this flag is used with - --format, the formatting is applied on this URI list. To display URIs - alongside other keys instead, use the uri() transform. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the 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. - diff --git a/gcloud/alpha/dataplex/datascan/run b/gcloud/alpha/dataplex/datascan/run deleted file mode 100644 index f22341777..000000000 --- a/gcloud/alpha/dataplex/datascan/run +++ /dev/null @@ -1,69 +0,0 @@ -NAME - gcloud alpha dataplex datascan run - run a Dataplex DataScan resource - -SYNOPSIS - gcloud alpha dataplex datascan run (DATASCAN : --location=LOCATION) - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) (DEPRECATED) This command is deprecated. Please use gcloud alpha - dataplex datascans instead. - - Run a Dataplex Datascan resource given a valid Datascan ID. - -EXAMPLES - To run a Dataplex Datascan test-datascan in location us-central1 , run: - - $ gcloud alpha dataplex datascan run test-datascan \ - --location=us-central1 - -POSITIONAL ARGUMENTS - Datascan resource - Arguments and flags that define the Dataplex Datascan - you want to run. 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 datascan 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. - - DATASCAN - ID of the datascan or fully qualified identifier for the datascan. - - To set the datascan attribute: - ▸ provide the argument datascan 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 Dataplex resource. - - To set the location attribute: - ▸ provide the argument datascan on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property dataplex/location. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -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. - diff --git a/gcloud/alpha/dataplex/help b/gcloud/alpha/dataplex/help index 2cc219b19..4c70667d4 100644 --- a/gcloud/alpha/dataplex/help +++ b/gcloud/alpha/dataplex/help @@ -27,9 +27,6 @@ GROUPS data-taxonomies (ALPHA) Manage Dataplex Data Taxonomies. - datascan - (ALPHA) (DEPRECATED) Manage Dataplex Datascan. - datascans (ALPHA) Manage Dataplex Datascan. diff --git a/gcloud/alpha/game/help b/gcloud/alpha/game/help deleted file mode 100644 index ecdc06c0d..000000000 --- a/gcloud/alpha/game/help +++ /dev/null @@ -1,36 +0,0 @@ -NAME - gcloud alpha game - managed Cloud Game Services - -SYNOPSIS - gcloud alpha game GROUP [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Managed Cloud Game Services. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -GROUPS - GROUP is one of the following: - - locations - (ALPHA) Query Cloud Game Services Locations. - - operations - (ALPHA) Deploy and manage Cloud Game Services Operations. - - servers - (ALPHA) Managed Cloud Game Servers. - -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 game - - $ gcloud beta game - diff --git a/gcloud/alpha/game/locations/describe b/gcloud/alpha/game/locations/describe deleted file mode 100644 index c48e4cbf1..000000000 --- a/gcloud/alpha/game/locations/describe +++ /dev/null @@ -1,55 +0,0 @@ -NAME - gcloud alpha game locations describe - describe a Location - -SYNOPSIS - gcloud alpha game locations describe [LOCATION] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Describe a Cloud Game Services Location. - -EXAMPLES - To describe location 'my-location', run: - - $ gcloud alpha game locations describe my-location - -POSITIONAL ARGUMENTS - Location resource - Cloud Game Services Location to describe. This - represents a Cloud resource. (NOTE) Some attributes are not given - arguments in this group but can be set in other ways. - - To set the project attribute: - ◆ provide the argument location on the command line with a fully - specified name; - ◆ set the property game_services/location with a fully specified name; - ◆ set the property core/project; - ◆ provide the argument --project on the command line. - - [LOCATION] - ID of the location or fully qualified identifier for the location. - - To set the location attribute: - ▸ provide the argument location on the command line; - ▸ set the property game_services/location. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the gameservices/v1alpha API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -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 game locations describe - - $ gcloud beta game locations describe - diff --git a/gcloud/alpha/game/locations/help b/gcloud/alpha/game/locations/help deleted file mode 100644 index ef10a1d79..000000000 --- a/gcloud/alpha/game/locations/help +++ /dev/null @@ -1,33 +0,0 @@ -NAME - gcloud alpha game locations - query Cloud Game Services Locations - -SYNOPSIS - gcloud alpha game locations COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Query Cloud Game Services Locations. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -COMMANDS - COMMAND is one of the following: - - describe - (ALPHA) Describe a Location. - - list - (ALPHA) List Locations. - -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 game locations - - $ gcloud beta game locations - diff --git a/gcloud/alpha/game/locations/list b/gcloud/alpha/game/locations/list deleted file mode 100644 index 02543d97e..000000000 --- a/gcloud/alpha/game/locations/list +++ /dev/null @@ -1,70 +0,0 @@ -NAME - gcloud alpha game locations list - list Locations - -SYNOPSIS - gcloud alpha game locations list [--filter=EXPRESSION] [--limit=LIMIT] - [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) List Cloud Game Services Locations. - -EXAMPLES - To see the list of all Locations, run: - - $ gcloud alpha game locations list - -LIST COMMAND FLAGS - --filter=EXPRESSION - Apply a Boolean filter EXPRESSION to each resource item to be listed. - If the expression evaluates True, then that item is listed. For more - details and examples of filter expressions, run $ gcloud topic filters. - This flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --limit=LIMIT - Maximum number of resources to list. The default is unlimited. This - flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --page-size=PAGE_SIZE - Some services group resource list output into pages. This flag - specifies the maximum number of resources per page. The default is - determined by the service if it supports paging, otherwise it is - unlimited (no paging). Paging may be applied before or after --filter - and --limit depending on the service. - - --sort-by=[FIELD,...] - Comma-separated list of resource field key names to sort by. The - default order is ascending. Prefix a field with ``~'' for descending - order on that field. This flag interacts with other flags that are - applied in this order: --flatten, --sort-by, --filter, --limit. - - --uri - Print a list of resource URIs instead of the default output, and change - the command output to a list of URIs. If this flag is used with - --format, the formatting is applied on this URI list. To display URIs - alongside other keys instead, use the uri() transform. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the gameservices/v1alpha API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -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 game locations list - - $ gcloud beta game locations list - diff --git a/gcloud/alpha/game/operations/describe b/gcloud/alpha/game/operations/describe deleted file mode 100644 index adf6f5789..000000000 --- a/gcloud/alpha/game/operations/describe +++ /dev/null @@ -1,71 +0,0 @@ -NAME - gcloud alpha game operations describe - describe an Operation - -SYNOPSIS - gcloud alpha game operations describe (OPERATION : --location=LOCATION) - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Describe a Cloud Game Services Operation. - -EXAMPLES - To describe operation 'my-operation' in project 'my-project' and location - 'my-location', run: - - $ gcloud alpha game operations describe my-operation \ - --project=my-project --location=my-location - -POSITIONAL ARGUMENTS - Operation resource - Cloud Game Services Operation to describe. The - arguments in this group can be used to specify the attributes of this - resource. (NOTE) Some attributes are not given arguments in this group but - can be set in other ways. - - To set the project attribute: - ◆ provide the argument operation on the command line with a fully - specified name; - ◆ set the property core/project; - ◆ provide the argument --project on the command line. - - This must be specified. - - OPERATION - ID of the 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 - Google Cloud location. - - 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; - ▸ set the property game_services/location. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the gameservices/v1alpha API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -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 game operations describe - - $ gcloud beta game operations describe - diff --git a/gcloud/alpha/game/operations/help b/gcloud/alpha/game/operations/help deleted file mode 100644 index 06ef25cfd..000000000 --- a/gcloud/alpha/game/operations/help +++ /dev/null @@ -1,34 +0,0 @@ -NAME - gcloud alpha game operations - deploy and manage Cloud Game Services - Operations - -SYNOPSIS - gcloud alpha game operations COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Deploy and manage Cloud Game Services Operations. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -COMMANDS - COMMAND is one of the following: - - describe - (ALPHA) Describe an Operation. - - list - (ALPHA) List 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. These variants are also available: - - $ gcloud game operations - - $ gcloud beta game operations - diff --git a/gcloud/alpha/game/operations/list b/gcloud/alpha/game/operations/list deleted file mode 100644 index f960baefe..000000000 --- a/gcloud/alpha/game/operations/list +++ /dev/null @@ -1,91 +0,0 @@ -NAME - gcloud alpha game operations list - list Operations - -SYNOPSIS - gcloud alpha game operations list [--location=LOCATION] - [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] - [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) List Cloud Game Services Operations. - -EXAMPLES - To see the list of all Operations in project 'my-project' and location - 'my-location', run: - - $ gcloud alpha game operations list --project=my-project \ - --location=my-location - -FLAGS - Location resource - Cloud Game Services Location of the Operations to - list. 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 game_services/location 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; - ▸ set the property game_services/location. - -LIST COMMAND FLAGS - --filter=EXPRESSION - Apply a Boolean filter EXPRESSION to each resource item to be listed. - If the expression evaluates True, then that item is listed. For more - details and examples of filter expressions, run $ gcloud topic filters. - This flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --limit=LIMIT - Maximum number of resources to list. The default is unlimited. This - flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --page-size=PAGE_SIZE - Some services group resource list output into pages. This flag - specifies the maximum number of resources per page. The default is - determined by the service if it supports paging, otherwise it is - unlimited (no paging). Paging may be applied before or after --filter - and --limit depending on the service. - - --sort-by=[FIELD,...] - Comma-separated list of resource field key names to sort by. The - default order is ascending. Prefix a field with ``~'' for descending - order on that field. This flag interacts with other flags that are - applied in this order: --flatten, --sort-by, --filter, --limit. - - --uri - Print a list of resource URIs instead of the default output, and change - the command output to a list of URIs. If this flag is used with - --format, the formatting is applied on this URI list. To display URIs - alongside other keys instead, use the uri() transform. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the gameservices/v1alpha API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -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 game operations list - - $ gcloud beta game operations list - diff --git a/gcloud/alpha/game/servers/clusters/create b/gcloud/alpha/game/servers/clusters/create deleted file mode 100644 index 3ac406970..000000000 --- a/gcloud/alpha/game/servers/clusters/create +++ /dev/null @@ -1,128 +0,0 @@ -NAME - gcloud alpha game servers clusters create - create a Game Server Cluster - -SYNOPSIS - gcloud alpha game servers clusters create - (CLUSTER : --location=LOCATION --realm=REALM) --dry-run - --gke-cluster=GKE_CLUSTER --namespace=NAMESPACE - [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] - [--preview-time=PREVIEW_TIME] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Create a Cloud Game Server Cluster. - -EXAMPLES - To create Game Server Cluster 'my-cluster' in project 'my-project', realm - 'my-realm', and location in 'my-location' run: - - $ gcloud alpha game servers clusters create my-cluster \ - --project=my-project --realm=my-realm --location=my-location \ - --gke-cluster=projects/my-project/locations/my-location/\ - clusters/my-gke-cluster --namespace=default --labels=a=x,b=y \ - --no-dry-run - - To preview Game Server Cluster creation for 'my-cluster' in project - 'my-project', realm 'my-realm', and location in 'my-location' run: - - $ gcloud alpha game servers clusters create my-cluster \ - --project=my-project --realm=my-realm --location=my-location \ - --gke-cluster=projects/my-project/locations/my-location/\ - clusters/my-gke-cluster --namespace=default --labels=a=x,b=y \ - --dry-run - -POSITIONAL ARGUMENTS - Game server cluster resource - Cloud Game Server Cluster 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 cluster 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. - - CLUSTER - ID of the game server cluster or fully qualified identifier for the - game server cluster. - - To set the cluster attribute: - ▸ provide the argument cluster on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --location=LOCATION - Google Cloud location. - - To set the location attribute: - ▸ provide the argument cluster on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - - --realm=REALM - Cloud Game Servers Realm. - - To set the realm attribute: - ▸ provide the argument cluster on the command line with a fully - specified name; - ▸ provide the argument --realm on the command line. - -REQUIRED FLAGS - --dry-run - Validate the creation, but do not execute it. - - --gke-cluster=GKE_CLUSTER - Full or partial name of a cluster in Google Kubernetes Engine (GKE) - where the game server cluster is installed, using the format: - 'projects/{project_id}/locations/{location_id}/clusters/{cluster_id}'. - Note, the location of the GKE cluster can be either a region or a zone. - Example: 'projects/my-project/locations/us-central1/clusters/test'. If - project and location are not specified, the project and location of the - Game Server Cluster resource are used to generate the full name of the - GKE cluster. - - --namespace=NAMESPACE - Namespace for Kubernetes API server endpoint. - -OPTIONAL FLAGS - --description=DESCRIPTION - Game server cluster description. - - --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. - - --preview-time=PREVIEW_TIME - This attribute is only relevant for preview (--dry-run). It is used to - validate the state for a future time. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 gameservices/v1alpha API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -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 game servers clusters create - - $ gcloud beta game servers clusters create - diff --git a/gcloud/alpha/game/servers/clusters/delete b/gcloud/alpha/game/servers/clusters/delete deleted file mode 100644 index 29b4542ba..000000000 --- a/gcloud/alpha/game/servers/clusters/delete +++ /dev/null @@ -1,97 +0,0 @@ -NAME - gcloud alpha game servers clusters delete - delete a Game Server Cluster - -SYNOPSIS - gcloud alpha game servers clusters delete - (CLUSTER : --location=LOCATION --realm=REALM) --dry-run - [--preview-time=PREVIEW_TIME] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Delete a Game Server Cluster. - -EXAMPLES - To delete Game Server Cluster 'my-cluster' in project 'my-project', realm - 'my-realm', and location 'my-location' run: - - $ gcloud alpha game servers clusters delete my-cluster \ - --project=my-project --realm=my-realm --location=my-location \ - --no-dry-run - - To preview deletion of Game Server Cluster 'my-cluster' in project - 'my-project', realm 'my-realm', and location 'my-location' run: - - $ gcloud alpha game servers clusters delete my-cluster \ - --project=my-project --realm=my-realm --location=my-location \ - --dry-run - -POSITIONAL ARGUMENTS - Game Server Cluster resource - Cloud Game Server Cluster 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 cluster on the command line with a fully - specified name; - ◆ provide the argument --project on the command line; - ◆ set the property core/project. - - This must be specified. - - CLUSTER - ID of the Game Server Cluster or fully qualified identifier for the - Game Server Cluster. - - To set the name attribute: - ▸ provide the argument cluster on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --location=LOCATION - Google Cloud location. - - To set the location attribute: - ▸ provide the argument cluster on the command line with a fully - specified name; - ▸ provide the argument --location on the command line. - - --realm=REALM - Cloud Game Server Realm. - - To set the realm attribute: - ▸ provide the argument cluster on the command line with a fully - specified name; - ▸ provide the argument --realm on the command line. - -REQUIRED FLAGS - --dry-run - Validate the operation, but do not execute it. - -OPTIONAL FLAGS - --preview-time=PREVIEW_TIME - This attribute is only relevant for preview (--dry-run). It is used to - validate the state for a future time. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 gameservices API. The full documentation for this API - can be found at: https://cloud.google.com/solutions/gaming/ - -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 game servers clusters delete - - $ gcloud beta game servers clusters delete - diff --git a/gcloud/alpha/game/servers/clusters/describe b/gcloud/alpha/game/servers/clusters/describe deleted file mode 100644 index 5287ae079..000000000 --- a/gcloud/alpha/game/servers/clusters/describe +++ /dev/null @@ -1,95 +0,0 @@ -NAME - gcloud alpha game servers clusters describe - describe a Game Server - Cluster - -SYNOPSIS - gcloud alpha game servers clusters describe - (CLUSTER : --location=LOCATION --realm=REALM) - [--view=VIEW; default="basic"] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Describe a Cloud Game Server Cluster. - -EXAMPLES - To describe Game Server Cluster 'my-cluster' in project 'my-project', realm - 'my-realm', and location 'my-location', run: - - $ gcloud alpha game servers clusters describe my-cluster \ - --project=my-project --realm=my-realm --location=my-location - -POSITIONAL ARGUMENTS - Game server cluster resource - Cloud Game Server Cluster 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 cluster 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. - - CLUSTER - ID of the game server cluster or fully qualified identifier for the - game server cluster. - - To set the cluster attribute: - ▸ provide the argument cluster on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --location=LOCATION - Google Cloud location. - - To set the location attribute: - ▸ provide the argument cluster on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - - --realm=REALM - Cloud Game Servers Realm. - - To set the realm attribute: - ▸ provide the argument cluster on the command line with a fully - specified name; - ▸ provide the argument --realm on the command line. - -FLAGS - --view=VIEW; default="basic" - There are two possible views, 'basic' and 'full'. The default view is - 'basic'. VIEW must be one of: - - basic - Include info of the game server cluster resource, but not the - registered Kubernetes cluster's info such as versions or provider. - - full - Include info for both the game server cluster resource and - registered Kuberentes cluster. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 gameservices/v1alpha API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -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 game servers clusters describe - - $ gcloud beta game servers clusters describe - diff --git a/gcloud/alpha/game/servers/clusters/help b/gcloud/alpha/game/servers/clusters/help deleted file mode 100644 index fbf7fb28e..000000000 --- a/gcloud/alpha/game/servers/clusters/help +++ /dev/null @@ -1,43 +0,0 @@ -NAME - gcloud alpha game servers clusters - deploy and manage Cloud Game Server - Clusters - -SYNOPSIS - gcloud alpha game servers clusters COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Deploy and manage Cloud Game Server Clusters. - -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 Game Server Cluster. - - delete - (ALPHA) Delete a Game Server Cluster. - - describe - (ALPHA) Describe a Game Server Cluster. - - list - (ALPHA) List Game Server Clusters. - - update - (ALPHA) Update a Game Server Cluster. - -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 game servers clusters - - $ gcloud beta game servers clusters - diff --git a/gcloud/alpha/game/servers/clusters/list b/gcloud/alpha/game/servers/clusters/list deleted file mode 100644 index 9b4eed604..000000000 --- a/gcloud/alpha/game/servers/clusters/list +++ /dev/null @@ -1,117 +0,0 @@ -NAME - gcloud alpha game servers clusters list - list Game Server Clusters - -SYNOPSIS - gcloud alpha game servers clusters list [--view=VIEW; default="basic"] - [--location=LOCATION --realm=REALM] [--filter=EXPRESSION] - [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) List Cloud Game Server Clusters. - -EXAMPLES - To see the list of all Game Server Clusters in project 'my-project', realm - 'my-realm', and location 'my-location', run: - - $ gcloud alpha game servers clusters list --project=my-project \ - --realm=my-realm --location=my-location - -FLAGS - --view=VIEW; default="basic" - There are two possible views, 'basic' and 'full'. The default view is - 'basic'. VIEW must be one of: - - basic - Include info of the game server cluster resource, but not the - registered Kubernetes cluster's info such as versions or provider. - - full - Include info for both the game server cluster resource and - registered Kuberentes cluster. - - Realm resource - Cloud Game Servers Realm of the Game Server Cluster to - list. 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 --realm on the command line with a fully - specified name; - ◆ set the property game_services/default_realm with a fully specified - name; - ◆ set the property core/project; - ◆ provide the argument --project on the command line. - - --location=LOCATION - Google Cloud location. - - To set the location attribute: - ▸ provide the argument --realm on the command line with a fully - specified name; - ▸ set the property game_services/default_realm with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - - --realm=REALM - ID of the realm or fully qualified identifier for the realm. - - To set the realm attribute: - ▸ provide the argument --realm on the command line; - ▸ set the property game_services/default_realm. - -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 gameservices/v1alpha API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -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 game servers clusters list - - $ gcloud beta game servers clusters list - diff --git a/gcloud/alpha/game/servers/clusters/update b/gcloud/alpha/game/servers/clusters/update deleted file mode 100644 index f1e6fb8a9..000000000 --- a/gcloud/alpha/game/servers/clusters/update +++ /dev/null @@ -1,132 +0,0 @@ -NAME - gcloud alpha game servers clusters update - update a Game Server Cluster - -SYNOPSIS - gcloud alpha game servers clusters update - (CLUSTER : --location=LOCATION --realm=REALM) --dry-run - [--description=DESCRIPTION] [--preview-time=PREVIEW_TIME] - [--update-labels=[KEY=VALUE,...]] - [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Update a Cloud Game Server Cluster. - -EXAMPLES - To update labels for Game Server Cluster 'my-cluster' in project - 'my-project', realm 'my-realm', and location in 'my-location' run: - - $ gcloud alpha game servers clusters update my-cluster \ - --project=my-project --realm=my-realm --location=my-location \ - --update-labels="key1=val1" --no-dry-run - - To preview Game Server Cluster label update for 'my-cluster' in project - 'my-project', realm 'my-realm', and location in 'my-location' run: - - $ gcloud alpha game servers clusters update my-cluster \ - --project=my-project --realm=my-realm --location=my-location \ - --update-labels="key1=val1" --dry-run - -POSITIONAL ARGUMENTS - Game server cluster resource - Cloud Game Server Cluster to update. The - arguments in this group can be used to specify the attributes of this - resource. (NOTE) Some attributes are not given arguments in this group but - can be set in other ways. - - To set the project attribute: - ◆ provide the argument cluster on the command line with a fully - specified name; - ◆ set the property core/project; - ◆ provide the argument --project on the command line. - - This must be specified. - - CLUSTER - ID of the game server cluster or fully qualified identifier for the - game server cluster. - - To set the cluster attribute: - ▸ provide the argument cluster on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --location=LOCATION - Google Cloud location. - - To set the location attribute: - ▸ provide the argument cluster on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - - --realm=REALM - Cloud Game Servers Realm. - - To set the realm attribute: - ▸ provide the argument cluster on the command line with a fully - specified name; - ▸ provide the argument --realm on the command line. - -REQUIRED FLAGS - --dry-run - Validate the changes, but do not execute it. - -OPTIONAL FLAGS - --description=DESCRIPTION - Description for the game server cluster. - - --preview-time=PREVIEW_TIME - This attribute is only relevant for preview (--dry-run). It is used to - validate the state for a future time. - - --update-labels=[KEY=VALUE,...] - List of label KEY=VALUE pairs to update. If a label exists, its value - is modified. Otherwise, a new label is created. - - Keys must start with a lowercase character and contain only hyphens - (-), underscores (_), lowercase characters, and numbers. Values must - contain only hyphens (-), underscores (_), lowercase characters, and - numbers. - - At most one of these can be specified: - - --clear-labels - Remove all labels. If --update-labels is also specified then - --clear-labels is applied first. - - For example, to remove all labels: - - $ gcloud alpha game servers clusters update --clear-labels - - To remove all existing labels and create two new labels, foo and baz: - - $ gcloud alpha game servers clusters update --clear-labels \ - --update-labels foo=bar,baz=qux - - --remove-labels=[KEY,...] - List of label keys to remove. If a label does not exist it is - silently ignored. If --update-labels is also specified then - --update-labels is applied first. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the gameservices/v1alpha API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -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 game servers clusters update - - $ gcloud beta game servers clusters update - diff --git a/gcloud/alpha/game/servers/configs/create b/gcloud/alpha/game/servers/configs/create deleted file mode 100644 index 39121e5ad..000000000 --- a/gcloud/alpha/game/servers/configs/create +++ /dev/null @@ -1,142 +0,0 @@ -NAME - gcloud alpha game servers configs create - create a Game Server Config - -SYNOPSIS - gcloud alpha game servers configs create - (CONFIG : --deployment=DEPLOYMENT --location=LOCATION) - --fleet-configs-file=FLEET_CONFIGS_FILE [--async] - [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] - [--scaling-configs-file=SCALING_CONFIGS_FILE] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Create a Cloud Game Server Config for a Game Server Deployment. - -EXAMPLES - To create Game Server Config 'my-config' in project 'my-project', - deployment 'my-deployment', and location in 'global'(configs only support - the 'global' location) run: - - $ gcloud alpha game servers configs create my-config \ - --project=my-project --deployment=my-deployment \ - --location=global --deployment=my-deployment \ - --description=description --labels=a=x,b=y \ - --fleet-configs-file=fleet_configs.json - -POSITIONAL ARGUMENTS - Game server config resource - Cloud Game Server Config 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 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. - - CONFIG - ID of the game server config or fully qualified identifier for the - game server config. - - To set the config attribute: - ▸ provide the argument config on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --deployment=DEPLOYMENT - Cloud Game Servers Deployment. - - To set the deployment attribute: - ▸ provide the argument config on the command line with a fully - specified name; - ▸ provide the argument --deployment on the command line. - - --location=LOCATION - Google Cloud location. - - To set the location attribute: - ▸ provide the argument config on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -REQUIRED FLAGS - --fleet-configs-file=FLEET_CONFIGS_FILE - Path to a JSON or YAML file that contains fleet configs. The fleet spec - field in configs file follows Agones Fleet custom resource. Please see - https://github.com/googleforgames/agones/blob/master/examples/simple-udp/fleet.yaml - for example and https://agones.dev/site/docs/reference/fleet/ for Fleet - Spec definition. - -OPTIONAL FLAGS - --async - Return immediately, without waiting for the operation in progress to - complete. - - --description=DESCRIPTION - Game server config description. - - --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. - - --scaling-configs-file=SCALING_CONFIGS_FILE - Path to a JSON or YAML file that contains scaling configs. The fleet - autoscaler spec field in configs file follows Agones Fleet Autoscaler - custom resource. Please see - https://github.com/googleforgames/agones/blob/master/examples/simple-udp/fleetautoscaler.yaml - for example and https://agones.dev/site/docs/reference/fleetautoscaler/ - for Fleet Autoscaler Spec definition. Scaling config file can also - specifies schedules. Contents of a sample yaml file: - - - fleetAutoscalerSpec: - policy: - type: Buffer - buffer: - bufferSize: 10 - minReplicas: 10 - maxReplicas: 20 - name: scaling-config-2 - schedules: - - startTime: '2020-01-01T01:00:00Z' - endTime: '2020-01-02T01:00:00Z' - cronSpec: '0 9 * * *' - cronJobDuration: 3600s - - fleetAutoscalerSpec: - policy: - type: Buffer - buffer: - bufferSize: 2 - minReplicas: 2 - maxReplicas: 4 - name: scaling-config-1 - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 gameservices/v1alpha API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -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 game servers configs create - - $ gcloud beta game servers configs create - diff --git a/gcloud/alpha/game/servers/configs/delete b/gcloud/alpha/game/servers/configs/delete deleted file mode 100644 index 1bb0f5556..000000000 --- a/gcloud/alpha/game/servers/configs/delete +++ /dev/null @@ -1,87 +0,0 @@ -NAME - gcloud alpha game servers configs delete - delete a Game Server Config - -SYNOPSIS - gcloud alpha game servers configs delete - (CONFIG : --deployment=DEPLOYMENT --location=LOCATION) [--async] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Delete a Cloud Game Server Config. - -EXAMPLES - To delete Game Server Config 'my-config' in project 'my-project', - deployment 'my-deployment', and location 'global'(configs only support the - 'global' location), run: - - $ gcloud alpha game servers configs delete my-config \ - --project=my-project --deployment=deployment --location=global - -POSITIONAL ARGUMENTS - Game server config resource - Cloud Game Server Config 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 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. - - CONFIG - ID of the game server config or fully qualified identifier for the - game server config. - - To set the config attribute: - ▸ provide the argument config on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --deployment=DEPLOYMENT - Cloud Game Servers Deployment. - - To set the deployment attribute: - ▸ provide the argument config on the command line with a fully - specified name; - ▸ provide the argument --deployment on the command line. - - --location=LOCATION - Google Cloud location. - - To set the location attribute: - ▸ provide the argument config on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -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 gameservices/v1alpha API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -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 game servers configs delete - - $ gcloud beta game servers configs delete - diff --git a/gcloud/alpha/game/servers/configs/describe b/gcloud/alpha/game/servers/configs/describe deleted file mode 100644 index 09ef4ec0d..000000000 --- a/gcloud/alpha/game/servers/configs/describe +++ /dev/null @@ -1,83 +0,0 @@ -NAME - gcloud alpha game servers configs describe - describe a Game Server Config - -SYNOPSIS - gcloud alpha game servers configs describe - (CONFIG : --deployment=DEPLOYMENT --location=LOCATION) - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Describe a Cloud Game Server Config. - -EXAMPLES - To describe Game Server Config 'my-config' in project 'my-project', - deployment 'my-deployment' and location 'global'(configs only support the - 'global' location), run: - - $ gcloud alpha game servers configs describe my-config \ - --project=my-project --deployment=my-deployment \ - --location=global - -POSITIONAL ARGUMENTS - Game server config resource - Cloud Game Server Config 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 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. - - CONFIG - ID of the game server config or fully qualified identifier for the - game server config. - - To set the config attribute: - ▸ provide the argument config on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --deployment=DEPLOYMENT - Cloud Game Servers Deployment. - - To set the deployment attribute: - ▸ provide the argument config on the command line with a fully - specified name; - ▸ provide the argument --deployment on the command line. - - --location=LOCATION - Google Cloud location. - - To set the location attribute: - ▸ provide the argument config on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the gameservices/v1alpha API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -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 game servers configs describe - - $ gcloud beta game servers configs describe - diff --git a/gcloud/alpha/game/servers/configs/help b/gcloud/alpha/game/servers/configs/help deleted file mode 100644 index edb032bb4..000000000 --- a/gcloud/alpha/game/servers/configs/help +++ /dev/null @@ -1,40 +0,0 @@ -NAME - gcloud alpha game servers configs - deploy and manage Cloud Game Server - Configs - -SYNOPSIS - gcloud alpha game servers configs COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Deploy and manage Cloud Game Server Configs. - -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 Game Server Config. - - delete - (ALPHA) Delete a Game Server Config. - - describe - (ALPHA) Describe a Game Server Config. - - list - (ALPHA) List Configs. - -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 game servers configs - - $ gcloud beta game servers configs - diff --git a/gcloud/alpha/game/servers/deployments/create b/gcloud/alpha/game/servers/deployments/create deleted file mode 100644 index 2278d728f..000000000 --- a/gcloud/alpha/game/servers/deployments/create +++ /dev/null @@ -1,92 +0,0 @@ -NAME - gcloud alpha game servers deployments create - create a Deployment - -SYNOPSIS - gcloud alpha game servers deployments create - (DEPLOYMENT : --location=LOCATION) [--async] - [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Create a Cloud Game Server Deployment. - -EXAMPLES - To create Game Server Deployment 'my-deployment' in project 'my-project' - and location in 'global'(deployments only support the 'global' location) - run: - - $ gcloud alpha game servers deployments create my-deployment \ - --project=my-project --location=global \ - --description=description --labels=a=x,b=y - -POSITIONAL ARGUMENTS - Deployment resource - Cloud Game Server Deployment 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 deployment 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. - - DEPLOYMENT - ID of the deployment or fully qualified identifier for the - deployment. - - To set the deployment attribute: - ▸ provide the argument deployment 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 location. - - To set the location attribute: - ▸ provide the argument deployment on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -FLAGS - --async - Return immediately, without waiting for the operation in progress to - complete. - - --description=DESCRIPTION - Game server deployment description. - - --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 gameservices/v1alpha API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -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 game servers deployments create - - $ gcloud beta game servers deployments create - diff --git a/gcloud/alpha/game/servers/deployments/delete b/gcloud/alpha/game/servers/deployments/delete deleted file mode 100644 index 0fa78ae3f..000000000 --- a/gcloud/alpha/game/servers/deployments/delete +++ /dev/null @@ -1,77 +0,0 @@ -NAME - gcloud alpha game servers deployments delete - delete a Deployment - -SYNOPSIS - gcloud alpha game servers deployments delete - (DEPLOYMENT : --location=LOCATION) [--async] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Delete a Cloud Game Server Deployment. - -EXAMPLES - To delete Game Server Deployment 'my-deployment' in project 'my-project' - and location 'global'(deployments only support the 'global' location), run: - - $ gcloud alpha game servers deployments delete my-deployment \ - --project=my-project --location=global - -POSITIONAL ARGUMENTS - Deployment resource - Cloud Game Server Deployment 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 deployment 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. - - DEPLOYMENT - ID of the deployment or fully qualified identifier for the - deployment. - - To set the deployment attribute: - ▸ provide the argument deployment 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 location. - - To set the location attribute: - ▸ provide the argument deployment on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -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 gameservices/v1alpha API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -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 game servers deployments delete - - $ gcloud beta game servers deployments delete - diff --git a/gcloud/alpha/game/servers/deployments/describe b/gcloud/alpha/game/servers/deployments/describe deleted file mode 100644 index b25875cc5..000000000 --- a/gcloud/alpha/game/servers/deployments/describe +++ /dev/null @@ -1,72 +0,0 @@ -NAME - gcloud alpha game servers deployments describe - describe a Deployment - -SYNOPSIS - gcloud alpha game servers deployments describe - (DEPLOYMENT : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Describe a Cloud Game Server Deployment. - -EXAMPLES - To describe Game Server Deployment 'my-deployment' in project 'my-project' - and location 'global'(deployments only support the 'global' location), run: - - $ gcloud alpha game servers deployments describe my-deployment \ - --project=my-project --location=global - -POSITIONAL ARGUMENTS - Deployment resource - Cloud Game Server Deployment 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 deployment 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. - - DEPLOYMENT - ID of the deployment or fully qualified identifier for the - deployment. - - To set the deployment attribute: - ▸ provide the argument deployment 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 location. - - To set the location attribute: - ▸ provide the argument deployment on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the gameservices/v1alpha API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -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 game servers deployments describe - - $ gcloud beta game servers deployments describe - diff --git a/gcloud/alpha/game/servers/deployments/describe-rollout b/gcloud/alpha/game/servers/deployments/describe-rollout deleted file mode 100644 index 248851e6b..000000000 --- a/gcloud/alpha/game/servers/deployments/describe-rollout +++ /dev/null @@ -1,73 +0,0 @@ -NAME - gcloud alpha game servers deployments describe-rollout - describe a Rollout - -SYNOPSIS - gcloud alpha game servers deployments describe-rollout - (DEPLOYMENT : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Describe a Cloud Game Server Deployment Rollout. - -EXAMPLES - To describe the Rollout of Game Server Deployment 'my-deployment' in - project 'my-project', and location 'global'(deployments only support the - 'global' location), run: - - $ gcloud alpha game servers deployments describe-rollout \ - my-deployment --project=my-project --location=global - -POSITIONAL ARGUMENTS - Deployment resource - Cloud Game Server Deployment Rollout 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 deployment 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. - - DEPLOYMENT - ID of the deployment or fully qualified identifier for the - deployment. - - To set the deployment attribute: - ▸ provide the argument deployment 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 location. - - To set the location attribute: - ▸ provide the argument deployment on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the gameservices/v1alpha API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -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 game servers deployments describe-rollout - - $ gcloud beta game servers deployments describe-rollout - diff --git a/gcloud/alpha/game/servers/deployments/fetch-state b/gcloud/alpha/game/servers/deployments/fetch-state deleted file mode 100644 index 72fb16324..000000000 --- a/gcloud/alpha/game/servers/deployments/fetch-state +++ /dev/null @@ -1,74 +0,0 @@ -NAME - gcloud alpha game servers deployments fetch-state - fetches the state of a - Deployment - -SYNOPSIS - gcloud alpha game servers deployments fetch-state - (DEPLOYMENT : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Fetches a Cloud Game Server Deployment State from all clusters. - -EXAMPLES - To fetch the deployment state for Game Server Deployment 'my-deployment' in - project 'my-project' and location 'global'(deployments only support the - 'global' location), run: - - $ gcloud alpha game servers deployments fetch-state my-deployment \ - --project=my-project --location=global - -POSITIONAL ARGUMENTS - Deployment resource - Cloud Game Server Deployment State to fetch. 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 deployment 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. - - DEPLOYMENT - ID of the deployment or fully qualified identifier for the - deployment. - - To set the deployment attribute: - ▸ provide the argument deployment 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 location. - - To set the location attribute: - ▸ provide the argument deployment on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the gameservices/v1alpha API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -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 game servers deployments fetch-state - - $ gcloud beta game servers deployments fetch-state - diff --git a/gcloud/alpha/game/servers/deployments/help b/gcloud/alpha/game/servers/deployments/help deleted file mode 100644 index ff1112e0e..000000000 --- a/gcloud/alpha/game/servers/deployments/help +++ /dev/null @@ -1,52 +0,0 @@ -NAME - gcloud alpha game servers deployments - deploy and manage Cloud Game Server - Deployments - -SYNOPSIS - gcloud alpha game servers deployments COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Deploy and manage Cloud Game Server Deployments. - -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 Deployment. - - delete - (ALPHA) Delete a Deployment. - - describe - (ALPHA) Describe a Deployment. - - describe-rollout - (ALPHA) Describe a Rollout. - - fetch-state - (ALPHA) Fetches the state of a Deployment. - - list - (ALPHA) List Deployments. - - update - (ALPHA) Update a Deployment. - - update-rollout - (ALPHA) Update a Deployment 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. These variants are also available: - - $ gcloud game servers deployments - - $ gcloud beta game servers deployments - diff --git a/gcloud/alpha/game/servers/deployments/list b/gcloud/alpha/game/servers/deployments/list deleted file mode 100644 index b8476a507..000000000 --- a/gcloud/alpha/game/servers/deployments/list +++ /dev/null @@ -1,91 +0,0 @@ -NAME - gcloud alpha game servers deployments list - list Deployments - -SYNOPSIS - gcloud alpha game servers deployments list [--location=LOCATION] - [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] - [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) List Cloud Game Server Deployments. - -EXAMPLES - To see the list of all Game Server Deployments in project 'my-project' and - location 'global'(deployments only support the 'global' location), run: - - $ gcloud alpha game servers deployments list --project=my-project \ - --location=global - -FLAGS - Location resource - Cloud Game Servers Location of the Deployments to - list. 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 game_services/location 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; - ▸ set the property game_services/location. - -LIST COMMAND FLAGS - --filter=EXPRESSION - Apply a Boolean filter EXPRESSION to each resource item to be listed. - If the expression evaluates True, then that item is listed. For more - details and examples of filter expressions, run $ gcloud topic filters. - This flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --limit=LIMIT - Maximum number of resources to list. The default is unlimited. This - flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --page-size=PAGE_SIZE - Some services group resource list output into pages. This flag - specifies the maximum number of resources per page. The default is - determined by the service if it supports paging, otherwise it is - unlimited (no paging). Paging may be applied before or after --filter - and --limit depending on the service. - - --sort-by=[FIELD,...] - Comma-separated list of resource field key names to sort by. The - default order is ascending. Prefix a field with ``~'' for descending - order on that field. This flag interacts with other flags that are - applied in this order: --flatten, --sort-by, --filter, --limit. - - --uri - Print a list of resource URIs instead of the default output, and change - the command output to a list of URIs. If this flag is used with - --format, the formatting is applied on this URI list. To display URIs - alongside other keys instead, use the uri() transform. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the gameservices/v1alpha API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -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 game servers deployments list - - $ gcloud beta game servers deployments list - diff --git a/gcloud/alpha/game/servers/deployments/update b/gcloud/alpha/game/servers/deployments/update deleted file mode 100644 index 25bcef668..000000000 --- a/gcloud/alpha/game/servers/deployments/update +++ /dev/null @@ -1,120 +0,0 @@ -NAME - gcloud alpha game servers deployments update - update a Deployment - -SYNOPSIS - gcloud alpha game servers deployments update - (DEPLOYMENT : --location=LOCATION) [--async] - [--description=DESCRIPTION] [--update-labels=[KEY=VALUE,...]] - [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Update a Cloud Game Server Deployment. - -EXAMPLES - To update description for Game Server Deployment 'my-deployment' in project - 'my-project', and location in 'global'(deployments only support the default - 'global' location) run: - - $ gcloud alpha game servers deployments update my-deployment \ - --project=my-project --location=global \ - --description="New description" - - To update labels for Game Server Deployment 'my-deployment' in project - 'my-project' run: - - $ gcloud alpha game servers deployments update my-deployment \ - --project=my-project --location=global \ - --update-labels="key1=val1" - -POSITIONAL ARGUMENTS - Deployment resource - Cloud Game Server Deployment to update. The - arguments in this group can be used to specify the attributes of this - resource. (NOTE) Some attributes are not given arguments in this group but - can be set in other ways. - - To set the project attribute: - ◆ provide the argument deployment 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. - - DEPLOYMENT - ID of the deployment or fully qualified identifier for the - deployment. - - To set the deployment attribute: - ▸ provide the argument deployment 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 location. - - To set the location attribute: - ▸ provide the argument deployment on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -FLAGS - --async - Return immediately, without waiting for the operation in progress to - complete. - - --description=DESCRIPTION - Description for the game server deployment. - - --update-labels=[KEY=VALUE,...] - List of label KEY=VALUE pairs to update. If a label exists, its value - is modified. Otherwise, a new label is created. - - Keys must start with a lowercase character and contain only hyphens - (-), underscores (_), lowercase characters, and numbers. Values must - contain only hyphens (-), underscores (_), lowercase characters, and - numbers. - - At most one of these can be specified: - - --clear-labels - Remove all labels. If --update-labels is also specified then - --clear-labels is applied first. - - For example, to remove all labels: - - $ gcloud alpha game servers deployments update --clear-labels - - To remove all existing labels and create two new labels, foo and baz: - - $ gcloud alpha game servers deployments update --clear-labels \ - --update-labels foo=bar,baz=qux - - --remove-labels=[KEY,...] - List of label keys to remove. If a label does not exist it is - silently ignored. If --update-labels is also specified then - --update-labels is applied first. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the gameservices/v1alpha API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -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 game servers deployments update - - $ gcloud beta game servers deployments update - diff --git a/gcloud/alpha/game/servers/deployments/update-rollout b/gcloud/alpha/game/servers/deployments/update-rollout deleted file mode 100644 index 2e61bfd63..000000000 --- a/gcloud/alpha/game/servers/deployments/update-rollout +++ /dev/null @@ -1,141 +0,0 @@ -NAME - gcloud alpha game servers deployments update-rollout - update a Deployment - Rollout - -SYNOPSIS - gcloud alpha game servers deployments update-rollout - (DEPLOYMENT : --location=LOCATION) --dry-run - [--preview-time=PREVIEW_TIME] - [--clear-config-overrides - | --config-overrides-file=CONFIG_OVERRIDES_FILE] - [--clear-default-config | --default-config=DEFAULT_CONFIG] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Update a Cloud Game Server Deployment Rollout. - -EXAMPLES - To update a rollout target with new default game server config: - - $ gcloud alpha game servers deployments update-rollout \ - example-deployment --default-config=version1 --no-dry-run - - To set a rollout target gradually by setting overrides in a YAML file using - the --config-overrides-file flag: - - $ gcloud alpha game servers deployments update-rollout \ - example-deployment \ - --config-overrides-file=gs-cfg-overrides.yaml --no-dry-run - - Contents of gs-cfg-overrides.yaml: - - - realmsSelector: - realms: - - projects/test-project-1/locations/us-west1/realms/realm-1 - - projects/test-project-1/locations/us-west1/realms/realm-2 - configVersion: version2 - - realmsSelector: - realms: - - projects/test-project-1/locations/us-west1/realms/realm-3 - configVersion: version3 - -POSITIONAL ARGUMENTS - Deployment resource - Cloud Game Server Deployment Resource to update. The - arguments in this group can be used to specify the attributes of this - 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 deployment 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. - - DEPLOYMENT - ID of the deployment or fully qualified identifier for the - deployment. - - To set the deployment attribute: - ▸ provide the argument deployment 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 location. - - To set the location attribute: - ▸ provide the argument deployment on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -REQUIRED FLAGS - --dry-run - Validate the rollout changes, but do not execute it. - -OPTIONAL FLAGS - --preview-time=PREVIEW_TIME - This attribute is only relevant for preview (--dry-run). It is used to - validate the state for a future time. - - At most one of these can be specified: - - --clear-config-overrides - Clear the config overrides. - - --config-overrides-file=CONFIG_OVERRIDES_FILE - JSON/YAML file that specifies the Game Server config overrides. This - file can be used to gradually rollout a new config version. The - following sample file indicates that the version2 config is rolled - out to realm-1 and realm-2 while the version3 config is deployed to - realm-3. The rest of the realms are deployed with the default config - version (if one is specified). Contents of a sample yaml file: - - - realmsSelector: - realms: - - projects/test-project-1/locations/us-west1/realms/realm-1 - - projects/test-project-1/locations/us-west1/realms/realm-2 - configVersion: version2 - - realmsSelector: - realms: - - projects/test-project-1/locations/us-west1/realms/realm-3 - configVersion: version3 - - At most one of these can be specified: - - --clear-default-config - Clear the default config. - - --default-config=DEFAULT_CONFIG - Game Server config to be deployed to all clusters. The value of this - field must match an existing game server config that is a - sub-resource to the given game server deployment. If not specified, - there won't be a default config which means only the clusters - specified in the config overrides will have configs applied. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 gameservices/v1alpha API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -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 game servers deployments update-rollout - - $ gcloud beta game servers deployments update-rollout - diff --git a/gcloud/alpha/game/servers/help b/gcloud/alpha/game/servers/help deleted file mode 100644 index 94fb17ddc..000000000 --- a/gcloud/alpha/game/servers/help +++ /dev/null @@ -1,39 +0,0 @@ -NAME - gcloud alpha game servers - managed Cloud Game Servers - -SYNOPSIS - gcloud alpha game servers GROUP [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Managed Cloud Game Servers. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -GROUPS - GROUP is one of the following: - - clusters - (ALPHA) Deploy and manage Cloud Game Server Clusters. - - configs - (ALPHA) Deploy and manage Cloud Game Server Configs. - - deployments - (ALPHA) Deploy and manage Cloud Game Server Deployments. - - realms - (ALPHA) Deploy and manage Cloud Game Server Realms. - -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 game servers - - $ gcloud beta game servers - diff --git a/gcloud/alpha/game/servers/realms/create b/gcloud/alpha/game/servers/realms/create deleted file mode 100644 index 35f438e92..000000000 --- a/gcloud/alpha/game/servers/realms/create +++ /dev/null @@ -1,95 +0,0 @@ -NAME - gcloud alpha game servers realms create - create a Realm - -SYNOPSIS - gcloud alpha game servers realms create (REALM : --location=LOCATION) - --time-zone=TIME_ZONE [--async] [--description=DESCRIPTION] - [--labels=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Create a Cloud Game Server Realm. - -EXAMPLES - To create Realm 'my-realm' in project 'my-project' with location in - 'my-location' and time zone 'UTC', run: - - $ gcloud alpha game servers realms create my-realm \ - --project=my-project --location=my-location --time-zone=UTC \ - --labels=a=x,b=y - -POSITIONAL ARGUMENTS - Realm resource - Cloud Game Server Realm 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 realm 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. - - REALM - ID of the realm or fully qualified identifier for the realm. - - To set the realm attribute: - ▸ provide the argument realm 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 location. - - To set the location attribute: - ▸ provide the argument realm on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -REQUIRED FLAGS - --time-zone=TIME_ZONE - Time zone where all realm-specific policies are evaluated. The value of - this field must be from the IANA time zone database: - https://www.iana.org/time-zones. - -OPTIONAL FLAGS - --async - Return immediately, without waiting for the operation in progress to - complete. - - --description=DESCRIPTION - Game server realm description. - - --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 gameservices/v1alpha API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -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 game servers realms create - - $ gcloud beta game servers realms create - diff --git a/gcloud/alpha/game/servers/realms/delete b/gcloud/alpha/game/servers/realms/delete deleted file mode 100644 index 133ea3d89..000000000 --- a/gcloud/alpha/game/servers/realms/delete +++ /dev/null @@ -1,76 +0,0 @@ -NAME - gcloud alpha game servers realms delete - delete a Realm - -SYNOPSIS - gcloud alpha game servers realms delete (REALM : --location=LOCATION) - [--async] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Delete a Cloud Game Server Realm. - -EXAMPLES - To delete Realm 'my-realm' in project 'my-project' and location - 'my-location', run: - - $ gcloud alpha game servers realms delete my-realm \ - --project=my-project --location=my-location - -POSITIONAL ARGUMENTS - Realm resource - Cloud Game Server Realm 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 realm 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. - - REALM - ID of the realm or fully qualified identifier for the realm. - - To set the realm attribute: - ▸ provide the argument realm 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 location. - - To set the location attribute: - ▸ provide the argument realm on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -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 gameservices/v1alpha API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -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 game servers realms delete - - $ gcloud beta game servers realms delete - diff --git a/gcloud/alpha/game/servers/realms/describe b/gcloud/alpha/game/servers/realms/describe deleted file mode 100644 index b2b8c3d4f..000000000 --- a/gcloud/alpha/game/servers/realms/describe +++ /dev/null @@ -1,71 +0,0 @@ -NAME - gcloud alpha game servers realms describe - describe a Realm - -SYNOPSIS - gcloud alpha game servers realms describe (REALM : --location=LOCATION) - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Describe a Cloud Game Server Realm. - -EXAMPLES - To describe Realm 'my-realm' in project 'my-project' and location - 'my-location', run: - - $ gcloud alpha game servers realms describe my-realm \ - --project=my-project --location=my-location - -POSITIONAL ARGUMENTS - Realm resource - Cloud Game Server Realm 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 realm 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. - - REALM - ID of the realm or fully qualified identifier for the realm. - - To set the realm attribute: - ▸ provide the argument realm 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 location. - - To set the location attribute: - ▸ provide the argument realm on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the gameservices/v1alpha API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -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 game servers realms describe - - $ gcloud beta game servers realms describe - diff --git a/gcloud/alpha/game/servers/realms/update b/gcloud/alpha/game/servers/realms/update deleted file mode 100644 index 80e19958c..000000000 --- a/gcloud/alpha/game/servers/realms/update +++ /dev/null @@ -1,134 +0,0 @@ -NAME - gcloud alpha game servers realms update - update a Realm - -SYNOPSIS - gcloud alpha game servers realms update (REALM : --location=LOCATION) - --dry-run [--description=DESCRIPTION] [--preview-time=PREVIEW_TIME] - [--time-zone=TIME_ZONE] [--update-labels=[KEY=VALUE,...]] - [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Update a Cloud Game Server Realm. - -EXAMPLES - To update Realm 'my-realm' in project 'my-project' and location in - 'my-location' with a new time-zone run: - - $ gcloud alpha game servers realms update my-realm \ - --project=my-project --location=my-location --time-zone=EST \ - --no-dry-run - - To preview Realm update for 'my-realm' in project 'my-project' and location - in 'my-location' with a new time-zone run: - - $ gcloud alpha game servers realms update my-realm \ - --project=my-project --location=my-location --time-zone=EST \ - --dry-run - - To update labels for Realm 'my-realm' in project 'my-project' and location - in 'my-location' run: - - $ gcloud alpha game servers realms update my-realm \ - --project=my-project --location=my-location \ - --update-labels="key1=val1" --no-dry-run - -POSITIONAL ARGUMENTS - Realm resource - Cloud Game Server Realm to update. The arguments in this - group can be used to specify the attributes of this resource. (NOTE) Some - attributes are not given arguments in this group but can be set in other - ways. - - To set the project attribute: - ◆ provide the argument realm 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. - - REALM - ID of the realm or fully qualified identifier for the realm. - - To set the realm attribute: - ▸ provide the argument realm 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 location. - - To set the location attribute: - ▸ provide the argument realm on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -REQUIRED FLAGS - --dry-run - Validate the changes, but do not execute it. - -OPTIONAL FLAGS - --description=DESCRIPTION - Description for the realm. - - --preview-time=PREVIEW_TIME - This attribute is only relevant for preview (--dry-run). It is used to - validate the state for a future time. - - --time-zone=TIME_ZONE - Time zone where all realm-specific policies are evaluated. The value of - this field must be from the IANA time zone database: - https://www.iana.org/time-zones. - - --update-labels=[KEY=VALUE,...] - List of label KEY=VALUE pairs to update. If a label exists, its value - is modified. Otherwise, a new label is created. - - Keys must start with a lowercase character and contain only hyphens - (-), underscores (_), lowercase characters, and numbers. Values must - contain only hyphens (-), underscores (_), lowercase characters, and - numbers. - - At most one of these can be specified: - - --clear-labels - Remove all labels. If --update-labels is also specified then - --clear-labels is applied first. - - For example, to remove all labels: - - $ gcloud alpha game servers realms update --clear-labels - - To remove all existing labels and create two new labels, foo and baz: - - $ gcloud alpha game servers realms update --clear-labels \ - --update-labels foo=bar,baz=qux - - --remove-labels=[KEY,...] - List of label keys to remove. If a label does not exist it is - silently ignored. If --update-labels is also specified then - --update-labels is applied first. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the gameservices/v1alpha API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -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 game servers realms update - - $ gcloud beta game servers realms update - diff --git a/gcloud/alpha/infra-manager/deployments/apply b/gcloud/alpha/infra-manager/deployments/apply index df3bd8963..94aef452a 100644 --- a/gcloud/alpha/infra-manager/deployments/apply +++ b/gcloud/alpha/infra-manager/deployments/apply @@ -75,7 +75,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument DEPLOYMENT on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property blueprints/location. + ▸ set the property infra-manager/location. FLAGS --artifacts-gcs-bucket=ARTIFACTS_GCS_BUCKET diff --git a/gcloud/alpha/infra-manager/deployments/export-lock b/gcloud/alpha/infra-manager/deployments/export-lock index a5e449444..ca92b6afc 100644 --- a/gcloud/alpha/infra-manager/deployments/export-lock +++ b/gcloud/alpha/infra-manager/deployments/export-lock @@ -47,7 +47,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument DEPLOYMENT on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property blueprints/location. + ▸ set the property infra-manager/location. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/infra-manager/deployments/export-statefile b/gcloud/alpha/infra-manager/deployments/export-statefile index ae03facb5..81d7f97ec 100644 --- a/gcloud/alpha/infra-manager/deployments/export-statefile +++ b/gcloud/alpha/infra-manager/deployments/export-statefile @@ -47,7 +47,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument DEPLOYMENT on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property blueprints/location. + ▸ set the property infra-manager/location. FLAGS --draft diff --git a/gcloud/alpha/infra-manager/deployments/import-statefile b/gcloud/alpha/infra-manager/deployments/import-statefile index 12a2ccd86..24e372b5e 100644 --- a/gcloud/alpha/infra-manager/deployments/import-statefile +++ b/gcloud/alpha/infra-manager/deployments/import-statefile @@ -49,7 +49,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument DEPLOYMENT on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property blueprints/location. + ▸ set the property infra-manager/location. REQUIRED FLAGS --lock-id=LOCK_ID diff --git a/gcloud/alpha/infra-manager/deployments/lock b/gcloud/alpha/infra-manager/deployments/lock index d33bdd8ee..521a8a00b 100644 --- a/gcloud/alpha/infra-manager/deployments/lock +++ b/gcloud/alpha/infra-manager/deployments/lock @@ -45,7 +45,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument DEPLOYMENT on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property blueprints/location. + ▸ set the property infra-manager/location. FLAGS --async diff --git a/gcloud/alpha/infra-manager/deployments/unlock b/gcloud/alpha/infra-manager/deployments/unlock index 6ea5cf78d..409995d4c 100644 --- a/gcloud/alpha/infra-manager/deployments/unlock +++ b/gcloud/alpha/infra-manager/deployments/unlock @@ -48,7 +48,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument DEPLOYMENT on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property blueprints/location. + ▸ set the property infra-manager/location. REQUIRED FLAGS --lock-id=LOCK_ID diff --git a/gcloud/alpha/infra-manager/revisions/export-statefile b/gcloud/alpha/infra-manager/revisions/export-statefile index d54bf7cf5..edf3218c1 100644 --- a/gcloud/alpha/infra-manager/revisions/export-statefile +++ b/gcloud/alpha/infra-manager/revisions/export-statefile @@ -56,7 +56,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument REVISION on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property blueprints/location. + ▸ set the property infra-manager/location. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/services/vpc-peerings/enable-vpc-service-controls b/gcloud/alpha/services/vpc-peerings/enable-vpc-service-controls index b66afd37a..4e97179d5 100644 --- a/gcloud/alpha/services/vpc-peerings/enable-vpc-service-controls +++ b/gcloud/alpha/services/vpc-peerings/enable-vpc-service-controls @@ -9,15 +9,35 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) This command enables VPC Service Controls for the peering - connection. + (ALPHA) This command configures IPv4 routes and DNS zones applicable to a + service producer VPC network (for example, servicenetworking). The route + and DNS configuration match those recommended for using the + restricted.googleapis.com VIP: - The local default route (destination 0.0.0.0/0, next hop default internet - gateway) is deleted in the service producer VPC network. After deletion, - the service producer VPC network can import a custom default route from the - peering connection to the customer VPC network. This requires that the - customer VPC network be configured to export custom routes. The custom - default route cannot have an associated network tag. + When enabled, Google Cloud makes the following route configuration changes + in the service producer VPC network: Google Cloud removes the IPv4 default + route (destination 0.0.0.0/0, next hop default internet gateway). Google + Cloud then creates an IPv4 route for destination 199.36.153.4/30 using the + default internet gateway next hop. + + When enabled, Google Cloud also creates Cloud DNS managed private zones and + authorizes those zones for the service producer VPC network. The zones + include googleapis.com, pkg.dev, gcr.io, and other necessary domains or + host names for Google APIs and services that are compatible with VPC + Service Controls. Record data in the zones resolves all host names to + 199.36.153.4, 199.36.153.5, 199.36.153.6, and 199.36.153.7. + + When disabled, Google Cloud makes the following route configuration changes + in the service producer VPC network: Google Cloud restores a default route + (destination 0.0.0.0/0, next hop default internet gateway). Google Cloud + also deletes the Cloud DNS managed private zones that provided the host + name overrides. + + While enabled, the service producer VPC network can still import static and + dynamic routes from the peered customer network if you enable custom route + export. These custom routes can include a default route. For this reason, + this command is not to be used solely as a means for preventing access to + the internet. EXAMPLES To enable VPC Service Controls for a connection peering a network called diff --git a/gcloud/alpha/storage/buckets/create b/gcloud/alpha/storage/buckets/create index 413493c72..e025e7c2f 100644 --- a/gcloud/alpha/storage/buckets/create +++ b/gcloud/alpha/storage/buckets/create @@ -13,8 +13,9 @@ SYNOPSIS [--placement=REGION,REGION] [--recovery-point-objective=SETTING, --rpo=SETTING] [--retention-period=RETENTION_PERIOD] - [--[no-]uniform-bucket-level-access, -b] [--[no-]enable-autoclass] - [GCLOUD_WIDE_FLAG ...] + [--[no-]uniform-bucket-level-access, -b] + [--autoclass-terminal-storage-class=AUTOCLASS_TERMINAL_STORAGE_CLASS + --[no-]enable-autoclass] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Create new buckets. @@ -100,6 +101,11 @@ FLAGS --no-uniform-bucket-level-access to disable. AUTOCLASS FLAGS + --autoclass-terminal-storage-class=AUTOCLASS_TERMINAL_STORAGE_CLASS + The storage class that objects in the bucket eventually transition to + if they are not read for a certain length of time. Only valid if + Autoclass is enabled. + --[no-]enable-autoclass The Autoclass feature automatically selects the best storage class for objects based on access patterns. Use --enable-autoclass to enable and diff --git a/gcloud/alpha/storage/buckets/update b/gcloud/alpha/storage/buckets/update index 1a7ff8491..ed38748b8 100644 --- a/gcloud/alpha/storage/buckets/update +++ b/gcloud/alpha/storage/buckets/update @@ -4,7 +4,9 @@ NAME SYNOPSIS gcloud alpha storage buckets update URL [URL ...] [--additional-headers=HEADER=VALUE] [--continue-on-error, -c] - [--[no-]default-event-based-hold] [--lock-retention-period] + [--[no-]default-event-based-hold] + [--default-storage-class=DEFAULT_STORAGE_CLASS] + [--lock-retention-period] [--recovery-point-objective=SETTING, --rpo=SETTING] [--[no-]requester-pays] [--[no-]uniform-bucket-level-access] [--[no-]versioning] @@ -30,7 +32,8 @@ SYNOPSIS [--clear-web-error-page | --web-error-page=WEB_ERROR_PAGE] [--clear-web-main-page-suffix | --web-main-page-suffix=WEB_MAIN_PAGE_SUFFIX] - [--[no-]enable-autoclass] [GCLOUD_WIDE_FLAG ...] + [--autoclass-terminal-storage-class=AUTOCLASS_TERMINAL_STORAGE_CLASS + --[no-]enable-autoclass] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Update a bucket. @@ -71,6 +74,9 @@ FLAGS retroactively). Use --default-event-based-hold to enable and --no-default-event-based-hold to disable. + --default-storage-class=DEFAULT_STORAGE_CLASS + Sets the default storage class for the bucket. + --lock-retention-period Locks an unlocked retention policy on the buckets. Caution: A locked retention policy cannot be removed from a bucket or reduced in @@ -288,6 +294,11 @@ FLAGS usual bucket listing. AUTOCLASS FLAGS + --autoclass-terminal-storage-class=AUTOCLASS_TERMINAL_STORAGE_CLASS + The storage class that objects in the bucket eventually transition to + if they are not read for a certain length of time. Only valid if + Autoclass is enabled. + --[no-]enable-autoclass The Autoclass feature automatically selects the best storage class for objects based on access patterns. Use --enable-autoclass to enable and diff --git a/gcloud/alpha/storage/cp b/gcloud/alpha/storage/cp index 8f360b0aa..f392d829f 100644 --- a/gcloud/alpha/storage/cp +++ b/gcloud/alpha/storage/cp @@ -280,11 +280,10 @@ ENCRYPTION FLAGS encryption key can be a customer-supplied encryption key (An RFC 4648 section 4 base64-encoded AES256 string), or a customer-managed encryption key of the form - projects/{project}/locations/{location}/keyRings/ - {key-ring}/cryptoKeys/{crypto-key}. The specified key also acts as a - decryption key, which is useful when copying or moving encryted data to - a new location. Using this flag in an objects update command triggers a - rewrite of target objects. + projects/{project}/locations/{location}/keyRings/{key-ring}/cryptoKeys/{crypto-key}. + The specified key also acts as a decryption key, which is useful when + copying or moving encrypted data to a new location. Using this flag in + an objects update command triggers a rewrite of target objects. OBJECT METADATA FLAGS --cache-control=CACHE_CONTROL diff --git a/gcloud/alpha/storage/hash b/gcloud/alpha/storage/hash index b9dbc26b9..268a3dca5 100644 --- a/gcloud/alpha/storage/hash +++ b/gcloud/alpha/storage/hash @@ -27,7 +27,7 @@ EXAMPLES To get just the MD5 hash digest of a local object in hex format: - $ gcloud alpha storage hash /dir/object.txt --skip-md5 --hex + $ gcloud alpha storage hash /dir/object.txt --skip-crc32c --hex POSITIONAL ARGUMENTS URLS [URLS ...] diff --git a/gcloud/alpha/storage/mv b/gcloud/alpha/storage/mv index e7a148900..b11f015ad 100644 --- a/gcloud/alpha/storage/mv +++ b/gcloud/alpha/storage/mv @@ -287,11 +287,10 @@ ENCRYPTION FLAGS encryption key can be a customer-supplied encryption key (An RFC 4648 section 4 base64-encoded AES256 string), or a customer-managed encryption key of the form - projects/{project}/locations/{location}/keyRings/ - {key-ring}/cryptoKeys/{crypto-key}. The specified key also acts as a - decryption key, which is useful when copying or moving encryted data to - a new location. Using this flag in an objects update command triggers a - rewrite of target objects. + projects/{project}/locations/{location}/keyRings/{key-ring}/cryptoKeys/{crypto-key}. + The specified key also acts as a decryption key, which is useful when + copying or moving encrypted data to a new location. Using this flag in + an objects update command triggers a rewrite of target objects. OBJECT METADATA FLAGS --cache-control=CACHE_CONTROL diff --git a/gcloud/alpha/storage/objects/update b/gcloud/alpha/storage/objects/update index 40d99c35c..ac22b9f7d 100644 --- a/gcloud/alpha/storage/objects/update +++ b/gcloud/alpha/storage/objects/update @@ -140,11 +140,10 @@ ENCRYPTION FLAGS encryption key can be a customer-supplied encryption key (An RFC 4648 section 4 base64-encoded AES256 string), or a customer-managed encryption key of the form - projects/{project}/locations/{location}/keyRings/ - {key-ring}/cryptoKeys/{crypto-key}. The specified key also acts as a - decryption key, which is useful when copying or moving encryted data to - a new location. Using this flag in an objects update command triggers a - rewrite of target objects. + projects/{project}/locations/{location}/keyRings/{key-ring}/cryptoKeys/{crypto-key}. + The specified key also acts as a decryption key, which is useful when + copying or moving encrypted data to a new location. Using this flag in + an objects update command triggers a rewrite of target objects. OBJECT METADATA FLAGS --cache-control=CACHE_CONTROL diff --git a/gcloud/alpha/storage/operations/list b/gcloud/alpha/storage/operations/list index 34045c48d..661000ac3 100644 --- a/gcloud/alpha/storage/operations/list +++ b/gcloud/alpha/storage/operations/list @@ -2,7 +2,7 @@ NAME gcloud alpha storage operations list - list storage operations SYNOPSIS - gcloud alpha storage operations list OPERATION_NAME + gcloud alpha storage operations list PARENT_RESOURCE_NAME [--server-filter=SERVER_FILTER] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] @@ -25,14 +25,17 @@ EXAMPLES $ gcloud alpha storage operations list gs://my-bucket POSITIONAL ARGUMENTS - OPERATION_NAME - The operation name including the Cloud Storage bucket and operation ID. + PARENT_RESOURCE_NAME + The operation parent resource in the format + "projects/_/buckets/BUCKET". FLAGS --server-filter=SERVER_FILTER Server-side filter string used to determine what operations to return. - Example: (done = true AND complete_time >= "2023-01-01T00:00:00Z") OR - requested_cancellation = true + Example: '(done = true AND complete_time >= "2023-01-01T00:00:00Z") OR + requested_cancellation = true' Note that the entire filter string must + be in quotes and date strings within the filter must be in embedded + quotes. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/alpha/storage/rsync b/gcloud/alpha/storage/rsync index 253302a82..4ae2501de 100644 --- a/gcloud/alpha/storage/rsync +++ b/gcloud/alpha/storage/rsync @@ -223,11 +223,10 @@ ENCRYPTION FLAGS encryption key can be a customer-supplied encryption key (An RFC 4648 section 4 base64-encoded AES256 string), or a customer-managed encryption key of the form - projects/{project}/locations/{location}/keyRings/ - {key-ring}/cryptoKeys/{crypto-key}. The specified key also acts as a - decryption key, which is useful when copying or moving encryted data to - a new location. Using this flag in an objects update command triggers a - rewrite of target objects. + projects/{project}/locations/{location}/keyRings/{key-ring}/cryptoKeys/{crypto-key}. + The specified key also acts as a decryption key, which is useful when + copying or moving encrypted data to a new location. Using this flag in + an objects update command triggers a rewrite of target objects. OBJECT METADATA FLAGS --cache-control=CACHE_CONTROL diff --git a/gcloud/alpha/tasks/cmek-config/describe b/gcloud/alpha/tasks/cmek-config/describe new file mode 100644 index 000000000..90a5ade40 --- /dev/null +++ b/gcloud/alpha/tasks/cmek-config/describe @@ -0,0 +1,38 @@ +NAME + gcloud alpha tasks cmek-config describe - get CMEK configuration for Cloud + Tasks in the specified location + +SYNOPSIS + gcloud alpha tasks cmek-config describe --location=LOCATION + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Get CMEK configuration for Cloud Tasks in the specified location. + +EXAMPLES + To get a CMEK config: + + $ gcloud alpha tasks cmek-config describe --location=my-location + +REQUIRED FLAGS + --location=LOCATION + Google Cloud location for the KMS key. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --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 tasks cmek-config describe + + $ gcloud beta tasks cmek-config describe + diff --git a/gcloud/alpha/game/servers/realms/help b/gcloud/alpha/tasks/cmek-config/help similarity index 50% rename from gcloud/alpha/game/servers/realms/help rename to gcloud/alpha/tasks/cmek-config/help index 807478195..59bdfbdab 100644 --- a/gcloud/alpha/game/servers/realms/help +++ b/gcloud/alpha/tasks/cmek-config/help @@ -1,12 +1,12 @@ NAME - gcloud alpha game servers realms - deploy and manage Cloud Game Server - Realms + gcloud alpha tasks cmek-config - get or change CMEK configuration for Cloud + Tasks SYNOPSIS - gcloud alpha game servers realms COMMAND [GCLOUD_WIDE_FLAG ...] + gcloud alpha tasks cmek-config COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Deploy and manage Cloud Game Server Realms. + (ALPHA) Get or change CMEK configuration for Cloud Tasks. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -16,20 +16,13 @@ GCLOUD WIDE FLAGS COMMANDS COMMAND is one of the following: - create - (ALPHA) Create a Realm. - - delete - (ALPHA) Delete a Realm. - describe - (ALPHA) Describe a Realm. - - list - (ALPHA) List Realms. + (ALPHA) Get CMEK configuration for Cloud Tasks in the specified + location. update - (ALPHA) Update a Realm. + (ALPHA) Enable, disable, or edit CMEK configuration for Cloud Tasks in + the specified location. NOTES This command is currently in alpha and might change without notice. If this @@ -37,7 +30,7 @@ NOTES project, you might be trying to access an API with an invitation-only early access allowlist. These variants are also available: - $ gcloud game servers realms + $ gcloud tasks cmek-config - $ gcloud beta game servers realms + $ gcloud beta tasks cmek-config diff --git a/gcloud/alpha/tasks/cmek-config/update b/gcloud/alpha/tasks/cmek-config/update new file mode 100644 index 000000000..701d4cf3f --- /dev/null +++ b/gcloud/alpha/tasks/cmek-config/update @@ -0,0 +1,70 @@ +NAME + gcloud alpha tasks cmek-config update - enable, disable, or edit CMEK + configuration for Cloud Tasks in the specified location + +SYNOPSIS + gcloud alpha tasks cmek-config update [--location=LOCATION] + [--clear-kms-key | [--kms-key-name=KMS_KEY_NAME + : --kms-keyring=KMS_KEYRING --kms-project=KMS_PROJECT]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Enable, disable, or edit CMEK configuration for Cloud Tasks in the + specified location. + +EXAMPLES + To update a CMEK config: + + $ gcloud alpha tasks cmek-config update \ + --kms-key-name=projects/my-project/locations/my-location/\ + keyRings/my-keyring/cryptoKeys/key + +FLAGS + --location=LOCATION + Google Cloud location for the KMS key. + + Flags for Clearing or Updating CMEK Resource + + At most one of these can be specified: + + Flags for clearing CMEK Resource key. + + --clear-kms-key + Disables CMEK for Cloud Tasks in the specified location by clearing + the Cloud KMS cryptokey from the Cloud Tasks project and CMEK + configuration. + + Flags for Updating CMEK Resource key + + --kms-key-name=KMS_KEY_NAME + Fully qualified identifier for the key or just the key ID. The + latter requires that the --kms-keyring and --kms-project flags be + provided too. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --kms-keyring=KMS_KEYRING + KMS keyring of the KMS key. + + --kms-project=KMS_PROJECT + Google Cloud project for the KMS key. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --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 tasks cmek-config update + + $ gcloud beta tasks cmek-config update + diff --git a/gcloud/alpha/tasks/help b/gcloud/alpha/tasks/help index aa803c871..7c44d4ddd 100644 --- a/gcloud/alpha/tasks/help +++ b/gcloud/alpha/tasks/help @@ -15,6 +15,9 @@ GCLOUD WIDE FLAGS GROUPS GROUP is one of the following: + cmek-config + (ALPHA) Get or change CMEK configuration for Cloud Tasks. + locations (ALPHA) Get information about Cloud Tasks locations. diff --git a/gcloud/alpha/transfer/appliances/delete b/gcloud/alpha/transfer/appliances/delete new file mode 100644 index 000000000..bb565ce4a --- /dev/null +++ b/gcloud/alpha/transfer/appliances/delete @@ -0,0 +1,58 @@ +NAME + gcloud alpha transfer appliances delete - delete a transfer appliance + +SYNOPSIS + gcloud alpha transfer appliances delete APPLIANCE [--region=REGION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete a specific transfer appliance. + +EXAMPLES + To delete an appliance, run: + + $ gcloud alpha transfer appliances delete APPLIANCE + +POSITIONAL ARGUMENTS + Appliance resource - The appliance to delete. 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 appliance 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 region attribute: + ◆ provide the argument appliance on the command line with a fully + specified name; + ◆ provide the argument --region on the command line. + + This must be specified. + + APPLIANCE + ID of the appliance or fully qualified identifier for the appliance. + + To set the appliance attribute: + ▸ provide the argument appliance on the command line. + +FLAGS + --region=REGION + The location affiliated with the appliance order to delete. REGION must + be one of: us-central1, europe-west1, asia-southeast1. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --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/transfer/appliances/describe b/gcloud/alpha/transfer/appliances/describe new file mode 100644 index 000000000..1fa073198 --- /dev/null +++ b/gcloud/alpha/transfer/appliances/describe @@ -0,0 +1,67 @@ +NAME + gcloud alpha transfer appliances describe - get configuration details about + a Transfer Appliance + +SYNOPSIS + gcloud alpha transfer appliances describe APPLIANCE [--region=REGION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Get configuration details about a specific transfer appliance. + +EXAMPLES + To describe an appliance, run: + + $ gcloud alpha transfer appliances describe APPLIANCE + + To view details of the order associated with an appliance, first obtain the + ORDER identifier, then use it to look up the order: + + $ gcloud alpha transfer appliances describe APPLIANCE \ + --format="value(order)" + + $ gcloud alpha transfer appliances describe orders describe ORDER + +POSITIONAL ARGUMENTS + Appliance resource - The appliance to describe. This represents a Cloud + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument appliance 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 region attribute: + ◆ provide the argument appliance on the command line with a fully + specified name; + ◆ provide the argument --region on the command line. + + This must be specified. + + APPLIANCE + ID of the appliance or fully qualified identifier for the appliance. + + To set the appliance attribute: + ▸ provide the argument appliance on the command line. + +FLAGS + --region=REGION + The location affiliated with the appliance order to describe. REGION + must be one of: us-central1, europe-west1, asia-southeast1. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --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/transfer/appliances/help b/gcloud/alpha/transfer/appliances/help new file mode 100644 index 000000000..2d2b34a62 --- /dev/null +++ b/gcloud/alpha/transfer/appliances/help @@ -0,0 +1,40 @@ +NAME + gcloud alpha transfer appliances - manage Transfer Appliances + +SYNOPSIS + gcloud alpha transfer appliances GROUP | COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Transfer Appliances are high-capacity storage devices that enable + the transfer and secure shipment of data to a Google upload facility, where + data is uploaded to Cloud Storage. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + orders + (ALPHA) Manage Transfer Appliance Orders. + +COMMANDS + COMMAND is one of the following: + + delete + (ALPHA) Delete a transfer appliance. + + describe + (ALPHA) Get configuration details about a Transfer Appliance. + + list + (ALPHA) List Transfer Appliances. + +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/game/servers/configs/list b/gcloud/alpha/transfer/appliances/list similarity index 52% rename from gcloud/alpha/game/servers/configs/list rename to gcloud/alpha/transfer/appliances/list index 642b46e0b..868ff5357 100644 --- a/gcloud/alpha/game/servers/configs/list +++ b/gcloud/alpha/transfer/appliances/list @@ -1,55 +1,72 @@ NAME - gcloud alpha game servers configs list - list Configs + gcloud alpha transfer appliances list - list Transfer Appliances SYNOPSIS - gcloud alpha game servers configs list - [--deployment=DEPLOYMENT --location=LOCATION] [--filter=EXPRESSION] + gcloud alpha transfer appliances list [--appliances=[APPLIANCES,...]] + [--orders=[ORDERS,...]] [--region=REGION] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) List Cloud Game Server Configs. + (ALPHA) List Transfer Appliances in a given project to show their state and + corresponding orders. EXAMPLES - To see the list of all Game Server Configs in project 'my-project', - deployment 'my-deployment' and location 'global'(configs only support the - 'global' location), run: + To list all appliances in your current project, run: - $ gcloud alpha game servers configs list --project=my-project \ - --deployment=my-deployment --location=global + $ gcloud alpha transfer appliances list + + To list all information about all jobs formatted as JSON, run: + + $ gcloud alpha transfer appliances list --format=json FLAGS - Deployment resource - Cloud Game Server Deployment of the Game Server - Configs to list. The arguments in this group can be used to specify the - attributes of this resource. (NOTE) Some attributes are not given + Appliances resource - The appliances to list. 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 --appliances 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 region attribute: + ◆ provide the argument --appliances on the command line with a fully + specified name; + ◆ provide the argument --region on the command line. + + --appliances=[APPLIANCES,...] + IDs of the appliancess or fully qualified identifiers for the + appliancess. + + To set the appliances attribute: + ▸ provide the argument --appliances on the command line. + + Orders resource - The orders associated with the appliances to list. 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 --deployment on the command line with a fully + ◆ provide the argument --orders on the command line with a fully specified name; - ◆ set the property game_services/default_deployment with a fully + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the region attribute: + ◆ provide the argument --orders on the command line with a fully specified name; - ◆ set the property core/project; - ◆ provide the argument --project on the command line. + ◆ provide the argument --region on the command line. - --deployment=DEPLOYMENT - ID of the deployment or fully qualified identifier for the - deployment. + --orders=[ORDERS,...] + IDs of the orderss or fully qualified identifiers for the orderss. - To set the deployment attribute: - ▸ provide the argument --deployment on the command line; - ▸ set the property game_services/default_deployment. + To set the orders attribute: + ▸ provide the argument --orders on the command line. - --location=LOCATION - Google Cloud location. - - To set the location attribute: - ▸ provide the argument --deployment on the command line with a - fully specified name; - ▸ set the property game_services/default_deployment with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. + --region=REGION + The location affiliated with the appliance order to list. REGION must + be one of: us-central1, europe-west1, asia-southeast1. LIST COMMAND FLAGS --filter=EXPRESSION @@ -91,17 +108,9 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. -API REFERENCE - This command uses the gameservices/v1alpha API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - 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 game servers configs list - - $ gcloud beta game servers configs list + access allowlist. diff --git a/gcloud/alpha/transfer/appliances/orders/create b/gcloud/alpha/transfer/appliances/orders/create new file mode 100644 index 000000000..2bcff1d52 --- /dev/null +++ b/gcloud/alpha/transfer/appliances/orders/create @@ -0,0 +1,254 @@ +NAME + gcloud alpha transfer appliances orders create - create an order for a + transfer appliance + +SYNOPSIS + gcloud alpha transfer appliances orders create NAME --country=COUNTRY + [--submit] [--clone=CLONE : --clone-region=CLONE_REGION] + [[--model=MODEL : --cmek=CMEK --display-name=DISPLAY_NAME + --internet-enabled + --offline-export=[manifest=MANIFEST],[source=SOURCE] + --offline-import=OFFLINE_IMPORT --online-import=ONLINE_IMPORT]] + [--address=[administrative-area=ADMINISTRATIVE-AREA], + [lines=LINES],[locality=LOCALITY],[postal-code=POSTAL-CODE] + --delivery-notes=DELIVERY_NOTES + --order-contact=[business=BUSINESS], + [emails=EMAILS],[name=NAME],[phone=PHONE] + --shipping-contact=[business=BUSINESS], + [emails=EMAILS],[name=NAME],[phone=PHONE]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) gcloud alpha transfer appliances orders create facilitates the + creation of Transfer Appliance orders. When an order is created, an + appliance record is created as well. + +EXAMPLES + To order a rackable appliance with 40 TB of storage, named my-appliance, a + Cloud Storage destination of my-bucket and the minimum amount of contact + information. + + $ gcloud alpha transfer appliances orders create my-appliance \ + --model=TA40_RACKABLE \ + --shipping-contact="name=Jane \ + Doe,emails=[jane@example.com],phone=12345678910" \ + --offline-import=gs://my-bucket \ + --order-contact="name=John \ + Doe,phone=123456578910,emails=[john@example.com]" --country=US \ + --address="lines=['1600 Amphitheatre \ + Parkway'],locality=Mountain \ + View,administrative-area=CA,postal-code=94043" + + To clone an appliance order with the ID my-appliance and location + us-central1, only changing the name and Cloud Storage destination: + + $ gcloud alpha transfer appliances orders create \ + my-other-appliance --country=US --clone=my-appliance \ + --clone-region=us-central1 --offline-import=my-other-bucket + + To use a flags file to create an appliance rather than provide a long list + of flags: + + $ gcloud alpha transfer appliances orders create my-appliance \ + --flags-file=FLAGS_FILE + + Example file with all possible flags set: + + --address: + lines: + - 1600 Amphitheatre Parkway + locality: Mountain View + administrative-area: California + postal-code: 94043 + --cmek: projects/p/locations/global/keyRings/kr/cryptoKeys/ck + --country: US + --delivery-notes: None + --display-name: test + --internet-enabled: + --model: TA40_RACKABLE + --offline-export: + source: gs://my-bucket/path + manifest: gs://my-other-bucket/manifest + --offline-import: gs://my-bucket/path + --online-import: gs://my-bucket/path + --order-contact: + business: Google + name: Jane Doe + phone: 1234567890 + emails: + - janedoe@example.com + --shipping-contact: + business: Google + name: John Doe + phone: 1234567890 + emails: + - johndoe@example.com + +POSITIONAL ARGUMENTS + NAME + Immutable ID that will uniquely identify the appliance. + +REQUIRED FLAGS + --country=COUNTRY + Country where the appliance will be shipped. Note that this cannot be + changed. To ship the appliance to a different country, clone the order + instead and set a different country and delivery address. To view a + complete list of country codes and names see + https://support.google.com/business/answer/6270107. COUNTRY must be one + of: US, AT, BE, BG, HR, CY, CZ, DK, EE, FI, FR, DE, GR, HU, IE, IT, LV, + LT, LU, MT, NL, PL, PT, RO, SK, SI, ES, SE, GB, CA, NO, CH, SG. + +FLAGS + --submit + When specified the order will be submitted immediately. By default, + orders are created in a draft state. Use gcloud alpha transfer + appliances orders update --submit to submit the order later. + + Order resource - The order to clone. The arguments in this group can be + used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --clone on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --clone=CLONE + ID of the order or fully qualified identifier for the order. + + To set the order attribute: + ▸ provide the argument --clone on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --clone-region=CLONE_REGION + The region affiliated with the order. + + To set the region attribute: + ▸ provide the argument --clone on the command line with a fully + specified name; + ▸ provide the argument --clone-region on the command line; + ▸ provide the argument --region on the command line. + +APPLIANCE FLAGS + --model=MODEL + Model of the appliance to order. MODEL must be one of: TA40_RACKABLE, + TA40_STANDALONE, TA300_RACKABLE, TA300_STANDALONE, TA7, EA_STORAGE_7, + EA_GPU_T4. + + --cmek=CMEK + Customer-managed key which will add additional layer of security. By + default data is encrypted with a Google-managed key. + + --display-name=DISPLAY_NAME + A mutable, user-settable name for both the appliance and the order. + + --internet-enabled + Gives the option to put the appliance into online mode, allowing it to + transfer data and/or remotely report progress to the cloud over the + network. When disabled only offline transfers are possible. + + --offline-export=[manifest=MANIFEST],[source=SOURCE] + Configuration for an offline export transfer, where data is downloaded + onto the appliance at Google and copied from the appliance at the + customer site. + + source + The Cloud Storage bucket or folder where the data is located, in + the form of gs://my-bucket/path/to/folder/. + + manifest + Specifies the path to the manifest in Cloud Storage. An example + path is gs://bucket_name/path/manifest.csv. The paths in the + manifest file are relative to bucketname. For example, to export + SOURCE_PATH/object1.pdf, manifest will have object1.pdf in the + first column, followed by object version (optional). For more + information see + https://cloud.google.com/storage-transfer/docs/manifest#object_storage_transfers. + + --offline-import=OFFLINE_IMPORT + Destination for a offline import, where data is loaded onto the + appliance at the customer site and ingested at Google. Should be in the + form of gs://my-bucket/path/to/folder/. + + --online-import=ONLINE_IMPORT + Destination for a online import, where data is loaded onto the + appliance and automatically transferred to Cloud Storage whenever it + has an internet connection. Should be in the form of + gs://my-bucket/path/to/folder/. + +DELIVERY FLAGS + --address=[administrative-area=ADMINISTRATIVE-AREA],[lines=LINES],[locality=LOCALITY],[postal-code=POSTAL-CODE] + Address where the appliance will be shipped. All fields (or list items) + have a maximum of 80 characters. For more information see + https://support.google.com/business/answer/6397478. + + lines + Line of the postal address that doesn't fit in the other fields. + For most countries/regions, the first line will include a street + number and street name. You can have up to 5 address lines. + + locality + Generally refers to the city/town portion of the address. + + administrative_area + The state or province where the business is located. Enter the full + name (e.g. "California"), common postal abbreviation (e.g. "CA"), + or subdivision (ISO 3166-2) code (e.g. "US-CA"). + + postal_code + The postal code of the address. + + --delivery-notes=DELIVERY_NOTES + Add any additional details about your order, such as site details and a + preference date when the appliance should be delivered. + + --order-contact=[business=BUSINESS],[emails=EMAILS],[name=NAME],[phone=PHONE] + business + Name of the business, if applicable. + + name + Name of the primary contact. + + phone + The phone number of the primary contact. Should be given in E.164 + format consisting of the country calling code (1 to 3 digits) and + the subscriber number, with no additional spaces or formatting, + e.g. 15552220123. + + emails + The email of the primary contact along with any additional email + addresses to include with all correspondence. + + --shipping-contact=[business=BUSINESS],[emails=EMAILS],[name=NAME],[phone=PHONE] + business + Name of the business, if applicable. + + name + Name of the primary contact. + + phone + The phone number of the primary contact. Should be given in E.164 + format consisting of the country calling code (1 to 3 digits) and + the subscriber number, with no additional spaces or formatting, + e.g. 15552220123. + + emails + The email of the primary contact along with any additional email + addresses to include with all correspondence. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --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/transfer/appliances/orders/delete b/gcloud/alpha/transfer/appliances/orders/delete new file mode 100644 index 000000000..54856150c --- /dev/null +++ b/gcloud/alpha/transfer/appliances/orders/delete @@ -0,0 +1,67 @@ +NAME + gcloud alpha transfer appliances orders delete - delete transfer appliance + orders + +SYNOPSIS + gcloud alpha transfer appliances orders delete ORDER [--keep-appliances] + [--region=REGION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete transfer appliance orders. + +EXAMPLES + To delete an order, run: + + $ gcloud alpha transfer appliances orders delete ORDER + + To delete an order but keep the associated appliance records: + + $ gcloud alpha transfer appliances orders delete ORDER \ + --keep-appliances + +POSITIONAL ARGUMENTS + Order resource - The order to delete. 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 order 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 region attribute: + ◆ provide the argument order on the command line with a fully specified + name; + ◆ provide the argument --region on the command line. + + This must be specified. + + ORDER + ID of the order or fully qualified identifier for the order. + + To set the order attribute: + ▸ provide the argument order on the command line. + +FLAGS + --keep-appliances + Keep appliances associated with the order rather than deleting them. + + --region=REGION + The location affiliated with the appliance order to delete. REGION must + be one of: us-central1, europe-west1, asia-southeast1. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --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/transfer/appliances/orders/describe b/gcloud/alpha/transfer/appliances/orders/describe new file mode 100644 index 000000000..f7ceb2703 --- /dev/null +++ b/gcloud/alpha/transfer/appliances/orders/describe @@ -0,0 +1,60 @@ +NAME + gcloud alpha transfer appliances orders describe - get information about + Transfer Appliance orders + +SYNOPSIS + gcloud alpha transfer appliances orders describe ORDER [--region=REGION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Get information about transfer appliance orders. + +EXAMPLES + To describe an order by name, including its prefix, run: + + $ gcloud alpha transfer appliances orders describe ORDER \ + --region=REGION + +POSITIONAL ARGUMENTS + Order resource - The order to describe. This represents a Cloud resource. + (NOTE) Some attributes are not given arguments in this group but can be + set in other ways. + + To set the project attribute: + ◆ provide the argument order 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 region attribute: + ◆ provide the argument order on the command line with a fully specified + name; + ◆ provide the argument --region on the command line. + + This must be specified. + + ORDER + ID of the order or fully qualified identifier for the order. + + To set the order attribute: + ▸ provide the argument order on the command line. + +FLAGS + --region=REGION + The location affiliated with the appliance order to describe. REGION + must be one of: us-central1, europe-west1, asia-southeast1. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --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/transfer/appliances/orders/help b/gcloud/alpha/transfer/appliances/orders/help new file mode 100644 index 000000000..76ea65d63 --- /dev/null +++ b/gcloud/alpha/transfer/appliances/orders/help @@ -0,0 +1,40 @@ +NAME + gcloud alpha transfer appliances orders - manage Transfer Appliance Orders + +SYNOPSIS + gcloud alpha transfer appliances orders COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Transfer Appliances are high-capacity storage devices that enable + the transfer and secure shipment of data to a Google upload facility, where + data is uploaded to Cloud Storage. + +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 an order for a transfer appliance. + + delete + (ALPHA) Delete transfer appliance orders. + + describe + (ALPHA) Get information about Transfer Appliance orders. + + list + (ALPHA) List Transfer Appliance orders. + + update + (ALPHA) Update an order for a transfer appliance. + +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/game/servers/realms/list b/gcloud/alpha/transfer/appliances/orders/list similarity index 50% rename from gcloud/alpha/game/servers/realms/list rename to gcloud/alpha/transfer/appliances/orders/list index b6ccb2517..4b426f39e 100644 --- a/gcloud/alpha/game/servers/realms/list +++ b/gcloud/alpha/transfer/appliances/orders/list @@ -1,39 +1,74 @@ NAME - gcloud alpha game servers realms list - list Realms + gcloud alpha transfer appliances orders list - list Transfer Appliance + orders SYNOPSIS - gcloud alpha game servers realms list [--location=LOCATION] - [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] - [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + gcloud alpha transfer appliances orders list + [--appliances=[APPLIANCES,...]] [--orders=[ORDERS,...]] + [--region=REGION] [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) List Cloud Game Server Realms. + (ALPHA) List Transfer Appliances in a given project to show their state and + corresponding orders. EXAMPLES - To see the list of all Realms in project 'my-project' and location - 'my-location', run: + To list all appliances in your current project, run: - $ gcloud alpha game servers realms list --project=my-project \ - --location=my-location + $ gcloud alpha transfer appliances orders list + + To list all information about all jobs formatted as JSON, run: + + $ gcloud alpha transfer appliances orders list --format=json FLAGS - Location resource - Cloud Game Servers Location of the Realms to list. + Appliances resource - The appliances associated with the orders to list. 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 + ◆ provide the argument --appliances on the command line with a fully specified name; - ◆ set the property game_services/location with a fully specified name; - ◆ set the property core/project; - ◆ provide the argument --project on the command line. + ◆ provide the argument --project on the command line; + ◆ set the property core/project. - --location=LOCATION - ID of the location or fully qualified identifier for the location. + To set the region attribute: + ◆ provide the argument --appliances on the command line with a fully + specified name; + ◆ provide the argument --region on the command line. - To set the location attribute: - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. + --appliances=[APPLIANCES,...] + IDs of the appliancess or fully qualified identifiers for the + appliancess. + + To set the appliances attribute: + ▸ provide the argument --appliances on the command line. + + Orders resource - The orders to list. 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 --orders 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 region attribute: + ◆ provide the argument --orders on the command line with a fully + specified name; + ◆ provide the argument --region on the command line. + + --orders=[ORDERS,...] + IDs of the orderss or fully qualified identifiers for the orderss. + + To set the orders attribute: + ▸ provide the argument --orders on the command line. + + --region=REGION + The location affiliated with the appliance order to list. REGION must + be one of: us-central1, europe-west1, asia-southeast1. LIST COMMAND FLAGS --filter=EXPRESSION @@ -75,17 +110,9 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. -API REFERENCE - This command uses the gameservices/v1alpha API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - 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 game servers realms list - - $ gcloud beta game servers realms list + access allowlist. diff --git a/gcloud/alpha/transfer/appliances/orders/update b/gcloud/alpha/transfer/appliances/orders/update new file mode 100644 index 000000000..dfcbe9004 --- /dev/null +++ b/gcloud/alpha/transfer/appliances/orders/update @@ -0,0 +1,177 @@ +NAME + gcloud alpha transfer appliances orders update - update an order for a + transfer appliance + +SYNOPSIS + gcloud alpha transfer appliances orders update ORDER [--region=REGION] + [--submit] + [--cmek=CMEK --display-name=DISPLAY_NAME --model=MODEL + --offline-export=[manifest=MANIFEST],[source=SOURCE] + --offline-import=OFFLINE_IMPORT --online-import=ONLINE_IMPORT] + [--address=[administrative-area=ADMINISTRATIVE-AREA], + [lines=LINES],[locality=LOCALITY],[postal-code=POSTAL-CODE] + --delivery-notes=DELIVERY_NOTES + --order-contact=[business=BUSINESS], + [emails=EMAILS],[name=NAME],[phone=PHONE] + --shipping-contact=[business=BUSINESS], + [emails=EMAILS],[name=NAME],[phone=PHONE]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) gcloud alpha transfer appliances orders update facilitates the + update of Transfer Appliance Orders. + +EXAMPLES + To update the shipping contact of an appliance called my-appliance: + + $ gcloud alpha transfer appliances orders update my-appliance \ + --shipping-contact="name=Jane \ + Doe,emails=[jane@example.com],phone=12345678910" + +POSITIONAL ARGUMENTS + Order resource - The order to update. 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 order 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 region attribute: + ◆ provide the argument order on the command line with a fully specified + name; + ◆ provide the argument --region on the command line. + + This must be specified. + + ORDER + ID of the order or fully qualified identifier for the order. + + To set the order attribute: + ▸ provide the argument order on the command line. + +FLAGS + --region=REGION + The location affiliated with the appliance order to update. REGION must + be one of: us-central1, europe-west1, asia-southeast1. + + --submit + Submits an order that is in draft. + +APPLIANCE FLAGS + --cmek=CMEK + Customer-managed key which will add additional layer of security. By + default data is encrypted with a Google-managed key. + + --display-name=DISPLAY_NAME + A mutable, user-settable name for both the appliance and the order. + + --model=MODEL + Model of the appliance to order. MODEL must be one of: TA40_RACKABLE, + TA40_STANDALONE, TA300_RACKABLE, TA300_STANDALONE, TA7, EA_STORAGE_7, + EA_GPU_T4. + + --offline-export=[manifest=MANIFEST],[source=SOURCE] + Configuration for an offline export transfer, where data is downloaded + onto the appliance at Google and copied from the appliance at the + customer site. + + source + The Cloud Storage bucket or folder where the data is located, in + the form of gs://my-bucket/path/to/folder/. + + manifest + Specifies the path to the manifest in Cloud Storage. An example + path is gs://bucket_name/path/manifest.csv. The paths in the + manifest file are relative to bucketname. For example, to export + SOURCE_PATH/object1.pdf, manifest will have object1.pdf in the + first column, followed by object version (optional). For more + information see + https://cloud.google.com/storage-transfer/docs/manifest#object_storage_transfers. + + --offline-import=OFFLINE_IMPORT + Destination for a offline import, where data is loaded onto the + appliance at the customer site and ingested at Google. Should be in the + form of gs://my-bucket/path/to/folder/. + + --online-import=ONLINE_IMPORT + Destination for a online import, where data is loaded onto the + appliance and automatically transferred to Cloud Storage whenever it + has an internet connection. Should be in the form of + gs://my-bucket/path/to/folder/. + +DELIVERY FLAGS + --address=[administrative-area=ADMINISTRATIVE-AREA],[lines=LINES],[locality=LOCALITY],[postal-code=POSTAL-CODE] + Address where the appliance will be shipped. All fields (or list items) + have a maximum of 80 characters. For more information see + https://support.google.com/business/answer/6397478. + + lines + Line of the postal address that doesn't fit in the other fields. + For most countries/regions, the first line will include a street + number and street name. You can have up to 5 address lines. + + locality + Generally refers to the city/town portion of the address. + + administrative_area + The state or province where the business is located. Enter the full + name (e.g. "California"), common postal abbreviation (e.g. "CA"), + or subdivision (ISO 3166-2) code (e.g. "US-CA"). + + postal_code + The postal code of the address. + + --delivery-notes=DELIVERY_NOTES + Add any additional details about your order, such as site details and a + preference date when the appliance should be delivered. + + --order-contact=[business=BUSINESS],[emails=EMAILS],[name=NAME],[phone=PHONE] + business + Name of the business, if applicable. + + name + Name of the primary contact. + + phone + The phone number of the primary contact. Should be given in E.164 + format consisting of the country calling code (1 to 3 digits) and + the subscriber number, with no additional spaces or formatting, + e.g. 15552220123. + + emails + The email of the primary contact along with any additional email + addresses to include with all correspondence. + + --shipping-contact=[business=BUSINESS],[emails=EMAILS],[name=NAME],[phone=PHONE] + business + Name of the business, if applicable. + + name + Name of the primary contact. + + phone + The phone number of the primary contact. Should be given in E.164 + format consisting of the country calling code (1 to 3 digits) and + the subscriber number, with no additional spaces or formatting, + e.g. 15552220123. + + emails + The email of the primary contact along with any additional email + addresses to include with all correspondence. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --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/transfer/help b/gcloud/alpha/transfer/help index 84d35a26c..da7dfeed2 100644 --- a/gcloud/alpha/transfer/help +++ b/gcloud/alpha/transfer/help @@ -28,6 +28,9 @@ GROUPS agents (ALPHA) Manage Transfer Service agents. + appliances + (ALPHA) Manage Transfer Appliances. + jobs (ALPHA) Manage transfer jobs. diff --git a/gcloud/alpha/workstations/clusters/create b/gcloud/alpha/workstations/clusters/create index 9e2b93022..04e9ee745 100644 --- a/gcloud/alpha/workstations/clusters/create +++ b/gcloud/alpha/workstations/clusters/create @@ -3,8 +3,9 @@ NAME SYNOPSIS gcloud alpha workstations clusters create (CLUSTER : --region=REGION) - [--async] [--enable-private-endpoint] [--labels=[KEY=VALUE,...]] - [--network=NETWORK] [--subnetwork=SUBNETWORK] [GCLOUD_WIDE_FLAG ...] + [--async] [--domain=DOMAIN] [--enable-private-endpoint] + [--labels=[KEY=VALUE,...]] [--network=NETWORK] + [--subnetwork=SUBNETWORK] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Create a workstation cluster. @@ -59,6 +60,9 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --domain=DOMAIN + Domain used by Workstations for HTTP ingress. + --enable-private-endpoint Default is false. If specified, the cluster will be assigned an internal IP address to the Cluster Gateway. This isolates the cluster's diff --git a/gcloud/artifacts/repositories/create b/gcloud/artifacts/repositories/create index 7b0140af0..96893f5f4 100644 --- a/gcloud/artifacts/repositories/create +++ b/gcloud/artifacts/repositories/create @@ -11,9 +11,10 @@ SYNOPSIS [--remote-apt-repo-path=REMOTE_APT_REPO_PATH] [--remote-docker-repo=REMOTE_DOCKER_REPO] [--remote-mvn-repo=REMOTE_MVN_REPO] [--remote-npm-repo=REMOTE_NPM_REPO] + [--remote-password-secret-version=REMOTE_PASSWORD_SECRET_VERSION] [--remote-python-repo=REMOTE_PYTHON_REPO] [--remote-repo-config-desc=REMOTE_REPO_CONFIG_DESC] - [--remote-yum-repo=REMOTE_YUM_REPO] + [--remote-username=REMOTE_USERNAME] [--remote-yum-repo=REMOTE_YUM_REPO] [--remote-yum-repo-path=REMOTE_YUM_REPO_PATH] [--upstream-policy-file=FILE] [--version-policy=VERSION_POLICY] [GCLOUD_WIDE_FLAG ...] @@ -157,6 +158,10 @@ OPTIONAL FLAGS (Npm only) Repo upstream for npm remote repository. REMOTE_NPM_REPO must be one of: [npmjs]. + --remote-password-secret-version=REMOTE_PASSWORD_SECRET_VERSION + Secret Manager secret version that contains password for the remote + repository upstream. + --remote-python-repo=REMOTE_PYTHON_REPO (Python only) Repo upstream for python remote repository. REMOTE_PYTHON_REPO must be one of: [pypi]. @@ -164,6 +169,9 @@ OPTIONAL FLAGS --remote-repo-config-desc=REMOTE_REPO_CONFIG_DESC The description for the remote repository config. + --remote-username=REMOTE_USERNAME + Remote Repository upstream registry username. + --remote-yum-repo=REMOTE_YUM_REPO (Yum only) Repository base for yum remote repository. REMOTE_YUM_REPO must be one of: [centos, centos-debug, centos-stream, centos-vault, diff --git a/gcloud/artifacts/repositories/update b/gcloud/artifacts/repositories/update index 5dd772e51..6bbb29cbf 100644 --- a/gcloud/artifacts/repositories/update +++ b/gcloud/artifacts/repositories/update @@ -5,7 +5,9 @@ NAME SYNOPSIS gcloud artifacts repositories update (REPOSITORY : --location=LOCATION) [--description=DESCRIPTION] [--immutable-tags] - [--update-labels=[KEY=VALUE,...]] [--upstream-policy-file=FILE] + [--remote-password-secret-version=REMOTE_PASSWORD_SECRET_VERSION] + [--remote-username=REMOTE_USERNAME] [--update-labels=[KEY=VALUE,...]] + [--upstream-policy-file=FILE] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -66,6 +68,13 @@ FLAGS cannot be deleted or moved to a different image digest, and tagged images cannot be deleted. + --remote-password-secret-version=REMOTE_PASSWORD_SECRET_VERSION + Secret Manager secret version that contains password for the remote + repository upstream. + + --remote-username=REMOTE_USERNAME + Remote Repository upstream registry username. + --update-labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to update. If a label exists, its value is modified. Otherwise, a new label is created. diff --git a/gcloud/asset/analyze-iam-policy b/gcloud/asset/analyze-iam-policy index db114348b..e5b7bacb2 100644 --- a/gcloud/asset/analyze-iam-policy +++ b/gcloud/asset/analyze-iam-policy @@ -143,3 +143,11 @@ GCLOUD WIDE FLAGS --trace-token, --user-output-enabled, --verbosity. Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha asset analyze-iam-policy + + $ gcloud beta asset analyze-iam-policy + diff --git a/gcloud/asset/analyze-iam-policy-longrunning b/gcloud/asset/analyze-iam-policy-longrunning index 381114bea..c4d593044 100644 --- a/gcloud/asset/analyze-iam-policy-longrunning +++ b/gcloud/asset/analyze-iam-policy-longrunning @@ -1,7 +1,7 @@ NAME gcloud asset analyze-iam-policy-longrunning - analyzes IAM policies that - match a request asynchronously and writes the analysis results to - Google Cloud Storage or BigQuery destination + match a request asynchronously and writes the results to Google Cloud + Storage or BigQuery destination SYNOPSIS gcloud asset analyze-iam-policy-longrunning @@ -22,7 +22,7 @@ SYNOPSIS DESCRIPTION Analyzes IAM policies that match a request asynchronously and writes the - analysis results to Google Cloud Storage or BigQuery destination. + results to Google Cloud Storage or BigQuery destination. EXAMPLES To find out which users have been granted the iam.serviceAccounts.actAs @@ -181,3 +181,11 @@ GCLOUD WIDE FLAGS --trace-token, --user-output-enabled, --verbosity. Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha asset analyze-iam-policy-longrunning + + $ gcloud beta asset analyze-iam-policy-longrunning + diff --git a/gcloud/asset/help b/gcloud/asset/help index bde57d7a8..151437d0d 100644 --- a/gcloud/asset/help +++ b/gcloud/asset/help @@ -32,7 +32,7 @@ COMMANDS analyze-iam-policy-longrunning Analyzes IAM policies that match a request asynchronously and writes - the analysis results to Google Cloud Storage or BigQuery destination. + the results to Google Cloud Storage or BigQuery destination. analyze-move Analyzes resource move. diff --git a/gcloud/beta/ai/indexes/create b/gcloud/beta/ai/indexes/create index 5a07776fa..fb2e1edfd 100644 --- a/gcloud/beta/ai/indexes/create +++ b/gcloud/beta/ai/indexes/create @@ -4,16 +4,19 @@ NAME SYNOPSIS gcloud beta ai indexes create --display-name=DISPLAY_NAME --metadata-file=METADATA_FILE [--description=DESCRIPTION] + [--encryption-kms-key-name=ENCRYPTION_KMS_KEY_NAME] [--index-update-method=INDEX_UPDATE_METHOD] [--labels=[KEY=VALUE,...]] [--metadata-schema-uri=METADATA_SCHEMA_URI] [--region=REGION] [GCLOUD_WIDE_FLAG ...] EXAMPLES - To create an index under project example in region us-central1, run: + To create an index under project example in region us-central1, encrypted + with KMS key kms-key-name, run: $ gcloud beta ai indexes create --display-name=index \ --description=test --metadata-file=path/to/your/metadata.json \ - --project=example --region=us-central1 + --project=example --region=us-central1 \ + --encryption-kms-key-name=kms-key-name REQUIRED FLAGS --display-name=DISPLAY_NAME @@ -27,6 +30,14 @@ OPTIONAL FLAGS --description=DESCRIPTION Description of the index. + --encryption-kms-key-name=ENCRYPTION_KMS_KEY_NAME + The Cloud KMS resource identifier of the customer managed encryption + key used to protect a resource. Has the form: + projects/my-project/locations/my-region/keyRings/my-kr/cryptoKeys/my-key. + + The key needs to be in the same region as where the compute resource is + created. + --index-update-method=INDEX_UPDATE_METHOD The update method to use with this index. Choose stream_update or batch_update. If not set, batch update will be used by default. diff --git a/gcloud/beta/asset/analyze-iam-policy b/gcloud/beta/asset/analyze-iam-policy new file mode 100644 index 000000000..351db1024 --- /dev/null +++ b/gcloud/beta/asset/analyze-iam-policy @@ -0,0 +1,154 @@ +NAME + gcloud beta asset analyze-iam-policy - BETA version, Analyzes IAM policies + that match a request + +SYNOPSIS + gcloud beta asset analyze-iam-policy + (--folder=FOLDER_ID | --organization=ORGANIZATION_ID + | --project=PROJECT_ID) [--access-time=ACCESS_TIME] + [--full-resource-name=FULL_RESOURCE_NAME] [--identity=IDENTITY] + [--saved-analysis-query=SAVED_ANALYSIS_QUERY] + [--analyze-service-account-impersonation + --execution-timeout=EXECUTION_TIMEOUT --expand-groups + --expand-resources --expand-roles + --output-group-edges --output-resource-edges --show-response] + [--permissions=[PERMISSIONS,...] --roles=[ROLES,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Analyzes IAM policies that match a request. + +EXAMPLES + To find out which users have been granted the iam.serviceAccounts.actAs + permission on a service account, run: + + $ gcloud beta asset analyze-iam-policy --organization=YOUR_ORG_ID \ + --full-resource-name=YOUR_SERVICE_ACCOUNT_FULL_RESOURCE_NAME \ + --permissions='iam.serviceAccounts.actAs' + + To find out which resources a user can access, run: + + $ gcloud beta asset analyze-iam-policy --organization=YOUR_ORG_ID \ + --identity='user:u1@foo.com' + + To find out which roles or permissions a user has been granted on a + project, run: + + $ gcloud beta asset analyze-iam-policy --organization=YOUR_ORG_ID \ + --full-resource-name=YOUR_PROJECT_FULL_RESOURCE_NAME \ + --identity='user:u1@foo.com' + + To find out which users have been granted the iam.serviceAccounts.actAs + permission on any applicable resources, run: + + $ gcloud beta asset analyze-iam-policy --organization=YOUR_ORG_ID \ + --permissions='iam.serviceAccounts.actAs' + +REQUIRED FLAGS + Exactly one of these must be specified: + + --folder=FOLDER_ID + Folder ID on which to perform the analysis. Only policies defined at + or below this folder will be targeted in the analysis. + + --organization=ORGANIZATION_ID + Organization ID on which to perform the analysis. Only policies + defined at or below this organization will be targeted in the + analysis. + + --project=PROJECT_ID + Project ID or number on which to perform the analysis. Only policies + defined at or below this project will be targeted in the analysis. + +OPTIONAL FLAGS + The hypothetical context to evaluate IAM conditions. + + --access-time=ACCESS_TIME + The hypothetical access timestamp to evaluate IAM conditions. + + Specifies a resource for analysis. Leaving it empty means ANY. + + --full-resource-name=FULL_RESOURCE_NAME + The full resource name. + + Specifies an identity for analysis. Leaving it empty means ANY. + + --identity=IDENTITY + The identity appearing in the form of principals in the IAM policy + binding. + + Specifies the name of a saved analysis query. + + --saved-analysis-query=SAVED_ANALYSIS_QUERY + The name of a saved query. When a saved_analysis_query is provided, + its query content will be used as the base query. Other flags' values + will override the base query to compose the final query to run. IDs + might be in one of the following formats: + ▸ projects/project_number/savedQueries/saved_query_id + folders/folder_number/savedQueries/saved_query_id + organizations/organization_number/savedQueries/saved_query_id + + The analysis options. + + --analyze-service-account-impersonation + If true, the response will include access analysis from identities to + resources via service account impersonation. This is a very expensive + operation, because many derived queries will be executed. We highly + recommend you use AnalyzeIamPolicyLongrunning rpc instead. Default is + false. + + --execution-timeout=EXECUTION_TIMEOUT + The amount of time the executable has to complete. See JSON + representation of Duration + (https://developers.google.com/protocol-buffers/docs/proto3#json). + Deafult is empty. + + --expand-groups + If true, the identities section of the result will expand any Google + groups appearing in an IAM policy binding. Default is false. + + --expand-resources + If true, the resource section of the result will expand any resource + attached to an IAM policy to include resources lower in the resource + hierarchy. Default is false. + + --expand-roles + If true, the access section of result will expand any roles appearing + in IAM policy bindings to include their permissions. Default is + false. + + --output-group-edges + If true, the result will output the relevant membership relationships + between groups. Default is false. + + --output-resource-edges + If true, the result will output the relevant parent/child + relationships between resources. Default is false. + + --show-response + If true, the response will be showed as-is in the command output. + + Specifies roles or permissions for analysis. Leaving it empty means ANY. + + --permissions=[PERMISSIONS,...] + The permissions to appear in the result. + + --roles=[ROLES,...] + The roles to appear in the result. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --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 asset analyze-iam-policy + + $ gcloud alpha asset analyze-iam-policy + diff --git a/gcloud/beta/asset/analyze-iam-policy-longrunning b/gcloud/beta/asset/analyze-iam-policy-longrunning new file mode 100644 index 000000000..3aecd5e0b --- /dev/null +++ b/gcloud/beta/asset/analyze-iam-policy-longrunning @@ -0,0 +1,192 @@ +NAME + gcloud beta asset analyze-iam-policy-longrunning - analyzes IAM policies + that match a request asynchronously and writes the results to Google + Cloud Storage or BigQuery destination + +SYNOPSIS + gcloud beta asset analyze-iam-policy-longrunning + (--folder=FOLDER_ID | --organization=ORGANIZATION_ID + | --project=PROJECT_ID) + (--gcs-output-path=GCS_OUTPUT_PATH + | [--bigquery-dataset=BIGQUERY_DATASET + --bigquery-table-prefix=BIGQUERY_TABLE_PREFIX + : --bigquery-partition-key=BIGQUERY_PARTITION_KEY + --bigquery-write-disposition=BIGQUERY_WRITE_DISPOSITION]) + [--access-time=ACCESS_TIME] [--full-resource-name=FULL_RESOURCE_NAME] + [--identity=IDENTITY] + [--analyze-service-account-impersonation --expand-groups + --expand-resources + --expand-roles --output-group-edges --output-resource-edges] + [--permissions=[PERMISSIONS,...] --roles=[ROLES,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Analyzes IAM policies that match a request asynchronously and writes + the results to Google Cloud Storage or BigQuery destination. + +EXAMPLES + To find out which users have been granted the iam.serviceAccounts.actAs + permission on a service account, and write analysis results to Google Cloud + Storage, run: + + $ gcloud beta asset analyze-iam-policy-longrunning \ + --organization=YOUR_ORG_ID \ + --full-resource-name=YOUR_SERVICE_ACCOUNT_FULL_RESOURCE_NAME \ + --permissions='iam.serviceAccounts.actAs' \ + --gcs-output-path='gs://YOUR_BUCKET_NAME/YOUR_OBJECT_NAME' + + To find out which resources a user can access, and write analysis results + to Google Cloud Storage, run: + + $ gcloud beta asset analyze-iam-policy-longrunning \ + --organization=YOUR_ORG_ID --identity='user:u1@foo.com' \ + --gcs-output-path='gs://YOUR_BUCKET_NAME/YOUR_OBJECT_NAME' + + To find out which roles or permissions a user has been granted on a + project, and write analysis results to BigQuery, run: + + $ gcloud beta asset analyze-iam-policy-longrunning \ + --organization=YOUR_ORG_ID \ + --full-resource-name=YOUR_PROJECT_FULL_RESOURCE_NAME \ + --identity='user:u1@foo.com' \ + --bigquery-dataset='projects/YOUR_PROJECT_ID/datasets/YOUR_DATAS\ + ET_ID' --bigquery-table-prefix='YOUR_BIGQUERY_TABLE_PREFIX' + + To find out which users have been granted the iam.serviceAccounts.actAs + permission on any applicable resources, and write analysis results to + BigQuery, run: + + $ gcloud beta asset analyze-iam-policy-longrunning \ + --organization=YOUR_ORG_ID \ + --permissions='iam.serviceAccounts.actAs' \ + --bigquery-dataset='projects/YOUR_PROJECT_ID/datasets/YOUR_DATAS\ + ET_ID' --bigquery-table-prefix='YOUR_BIGQUERY_TABLE_PREFIX' + +REQUIRED FLAGS + Exactly one of these must be specified: + + --folder=FOLDER_ID + Folder ID on which to perform the analysis. Only policies defined at + or below this folder will be targeted in the analysis. + + --organization=ORGANIZATION_ID + Organization ID on which to perform the analysis. Only policies + defined at or below this organization will be targeted in the + analysis. + + --project=PROJECT_ID + Project ID or number on which to perform the analysis. Only policies + defined at or below this project will be targeted in the analysis. + + The destination path for writing IAM policy analysis results. + + Exactly one of these must be specified: + + --gcs-output-path=GCS_OUTPUT_PATH + Google Cloud Storage URI where the results will be written. URI must + start with "gs://". For example, "gs://bucket_name/object_name". + + BigQuery destination where the results will go. + + --bigquery-dataset=BIGQUERY_DATASET + BigQuery dataset where the results will be written. Must be a + dataset relative name starting with "projects/". For example, + "projects/project_id/datasets/dataset_id". + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --bigquery-table-prefix=BIGQUERY_TABLE_PREFIX + The prefix of the BigQuery tables to which the analysis results + will be written. A table name consists of letters, numbers and + underscores". + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --bigquery-partition-key=BIGQUERY_PARTITION_KEY + This enum determines the partition key column for the bigquery + tables. Partitioning can improve query performance and reduce query + cost by filtering partitions. Refer to + https://cloud.google.com/bigquery/docs/partitioned-tables for + details. BIGQUERY_PARTITION_KEY must be one of: + PARTITION_KEY_UNSPECIFIED, REQUEST_TIME. + + --bigquery-write-disposition=BIGQUERY_WRITE_DISPOSITION + Specifies the action that occurs if the destination table or + partition already exists. The following values are supported: + WRITE_TRUNCATE, WRITE_APPEND and WRITE_EMPTY. The default value is + WRITE_APPEND. + +OPTIONAL FLAGS + The hypothetical context to evaluate IAM conditions. + + --access-time=ACCESS_TIME + The hypothetical access timestamp to evaluate IAM conditions. + + Specifies a resource for analysis. Leaving it empty means ANY. + + --full-resource-name=FULL_RESOURCE_NAME + The full resource name. + + Specifies an identity for analysis. Leaving it empty means ANY. + + --identity=IDENTITY + The identity appearing in the form of principals in the IAM policy + binding. + + The analysis options. + + --analyze-service-account-impersonation + If true, the response will include access analysis from identities to + resources via service account impersonation. This is a very expensive + operation, because many derived queries will be executed. We highly + recommend you use AnalyzeIamPolicyLongrunning rpc instead. Default is + false. + + --expand-groups + If true, the identities section of the result will expand any Google + groups appearing in an IAM policy binding. Default is false. + + --expand-resources + If true, the resource section of the result will expand any resource + attached to an IAM policy to include resources lower in the resource + hierarchy. Default is false. + + --expand-roles + If true, the access section of result will expand any roles appearing + in IAM policy bindings to include their permissions. Default is + false. + + --output-group-edges + If true, the result will output the relevant membership relationships + between groups. Default is false. + + --output-resource-edges + If true, the result will output the relevant parent/child + relationships between resources. Default is false. + + Specifies roles or permissions for analysis. Leaving it empty means ANY. + + --permissions=[PERMISSIONS,...] + The permissions to appear in the result. + + --roles=[ROLES,...] + The roles to appear in the result. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --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 asset analyze-iam-policy-longrunning + + $ gcloud alpha asset analyze-iam-policy-longrunning + diff --git a/gcloud/beta/asset/help b/gcloud/beta/asset/help index ccebb5c42..4b6516a62 100644 --- a/gcloud/beta/asset/help +++ b/gcloud/beta/asset/help @@ -27,6 +27,13 @@ GROUPS COMMANDS COMMAND is one of the following: + analyze-iam-policy + (BETA) BETA version, Analyzes IAM policies that match a request. + + analyze-iam-policy-longrunning + (BETA) Analyzes IAM policies that match a request asynchronously and + writes the results to Google Cloud Storage or BigQuery destination. + analyze-org-policies (BETA) Analyze organization policies under a scope. diff --git a/gcloud/beta/builds/help b/gcloud/beta/builds/help index d51b9eb8a..eb3e241ae 100644 --- a/gcloud/beta/builds/help +++ b/gcloud/beta/builds/help @@ -19,7 +19,7 @@ GROUPS (BETA) Manage connections for Google Cloud Build. repositories - (BETA) Manage repositories for Google Cloud Build. + (BETA) Manage repositories for Cloud Build. triggers (BETA) Create and manage build triggers for Google Cloud Build. @@ -49,7 +49,7 @@ COMMANDS (BETA) Reject a pending build. submit - (BETA) Submit a build using Google Cloud Build. + (BETA) Submit a build using Cloud Build. NOTES This command is currently in beta and might change without notice. These diff --git a/gcloud/beta/builds/repositories/help b/gcloud/beta/builds/repositories/help index 8f7c6e892..d02a442d7 100644 --- a/gcloud/beta/builds/repositories/help +++ b/gcloud/beta/builds/repositories/help @@ -1,12 +1,11 @@ NAME - gcloud beta builds repositories - manage repositories for Google Cloud - Build + gcloud beta builds repositories - manage repositories for Cloud Build SYNOPSIS gcloud beta builds repositories COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Manage repositories for Google Cloud Build. + (BETA) Manage repositories for Cloud Build. GCLOUD WIDE FLAGS These flags are available to all commands: --help. diff --git a/gcloud/beta/builds/submit b/gcloud/beta/builds/submit index f4199c64b..21e261049 100644 --- a/gcloud/beta/builds/submit +++ b/gcloud/beta/builds/submit @@ -1,5 +1,5 @@ NAME - gcloud beta builds submit - submit a build using Google Cloud Build + gcloud beta builds submit - submit a build using Cloud Build SYNOPSIS gcloud beta builds submit [[SOURCE] --no-source] [--async] [--no-cache] @@ -16,7 +16,7 @@ SYNOPSIS | --tag=TAG, -t TAG] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Submit a build using Google Cloud Build. + (BETA) Submit a build using Cloud Build. When the builds/use_kaniko property is True, builds submitted with --tag will use Kaniko (https://github.com/GoogleContainerTools/kaniko) to execute @@ -42,6 +42,20 @@ EXAMPLES $ gcloud beta builds submit "source.tgz" \ --tag=gcr.io/my-project/image --async + To submit a build with source from a Git repository + https://github.com/owner/repo: + + $ gcloud beta builds submit "https://github.com/owner/repo" \ + --git-source-revision=main --config=config.yaml + + To submit a build with source from a 2nd-gen Cloud Build repository + resource + projects/my-project/locations/us-west1/connections/my-conn/repositories/my-repo: + + $ gcloud beta builds submit \ + "projects/my-project/locations/us-west1/connections/my-conn/repo\ + sitories/my-repo" --revision=main + POSITIONAL ARGUMENTS At most one of these can be specified: @@ -79,10 +93,10 @@ FLAGS --dir=DIR Directory, relative to the source root, in which to run the build. This - is used when the build source is a 2nd-gen Google Cloud Build - repository resource. This must be a relative path. If a step's dir is - specified and is an absolute path, this value is ignored for that - step's execution. + is used when the build source is a 2nd-gen Cloud Build repository + resource. This must be a relative path. If a step's dir is specified + and is an absolute path, this value is ignored for that step's + execution. --disk-size=DISK_SIZE Machine disk size (GB) to run the build. @@ -136,7 +150,7 @@ FLAGS --revision=REVISION Revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref to run the build. This is used when the - build source is a 2nd-gen Google Cloud Build repository resource. + build source is a 2nd-gen Cloud Build repository resource. Cloud Build uses git fetch to fetch the revision from the Git repository; therefore make sure that the string you provide for diff --git a/gcloud/beta/builds/triggers/help b/gcloud/beta/builds/triggers/help index c69f3272e..97b2d2a65 100644 --- a/gcloud/beta/builds/triggers/help +++ b/gcloud/beta/builds/triggers/help @@ -38,7 +38,7 @@ COMMANDS (BETA) Import a build trigger. list - (BETA) List Google Cloud Build triggers for a project. + (BETA) List Cloud Build triggers for a project. run (BETA) Run a build trigger. diff --git a/gcloud/beta/builds/triggers/list b/gcloud/beta/builds/triggers/list index 5f155cb13..b8c424f81 100644 --- a/gcloud/beta/builds/triggers/list +++ b/gcloud/beta/builds/triggers/list @@ -1,6 +1,5 @@ NAME - gcloud beta builds triggers list - list Google Cloud Build triggers for a - project + gcloud beta builds triggers list - list Cloud Build triggers for a project SYNOPSIS gcloud beta builds triggers list [--region=REGION] [--filter=EXPRESSION] @@ -8,7 +7,7 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) List Google Cloud Build triggers for a project. + (BETA) List Cloud Build triggers for a project. EXAMPLES To list build triggers, run: diff --git a/gcloud/beta/builds/triggers/update/bitbucketserver b/gcloud/beta/builds/triggers/update/bitbucketserver index 5386de9f0..eb9fba002 100644 --- a/gcloud/beta/builds/triggers/update/bitbucketserver +++ b/gcloud/beta/builds/triggers/update/bitbucketserver @@ -1,6 +1,6 @@ NAME gcloud beta builds triggers update bitbucketserver - updates Bitbucket - Server trigger used by Google Cloud Build + Server trigger used by Cloud Build SYNOPSIS gcloud beta builds triggers update bitbucketserver @@ -21,7 +21,7 @@ SYNOPSIS | --update-substitutions=[KEY=VALUE,...]) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Updates Bitbucket Server trigger used by Google Cloud Build. + (BETA) Updates Bitbucket Server trigger used by Cloud Build. EXAMPLES To update the branch pattern of the trigger: diff --git a/gcloud/beta/builds/triggers/update/cloud-source-repositories b/gcloud/beta/builds/triggers/update/cloud-source-repositories index 9ac056882..43fbef80d 100644 --- a/gcloud/beta/builds/triggers/update/cloud-source-repositories +++ b/gcloud/beta/builds/triggers/update/cloud-source-repositories @@ -1,6 +1,6 @@ NAME gcloud beta builds triggers update cloud-source-repositories - updates - Cloud Source Repositories trigger used by Google Cloud Build + Cloud Source Repositories trigger used by Cloud Build SYNOPSIS gcloud beta builds triggers update cloud-source-repositories @@ -16,8 +16,7 @@ SYNOPSIS | --update-substitutions=[KEY=VALUE,...]) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Updates Cloud Source Repositories trigger used by Google Cloud - Build. + (BETA) Updates Cloud Source Repositories trigger used by Cloud Build. EXAMPLES To update the branch pattern of the trigger: diff --git a/gcloud/beta/builds/triggers/update/github b/gcloud/beta/builds/triggers/update/github index 539b2f3d8..db87956cc 100644 --- a/gcloud/beta/builds/triggers/update/github +++ b/gcloud/beta/builds/triggers/update/github @@ -1,6 +1,6 @@ NAME gcloud beta builds triggers update github - update GitHub trigger used by - Google Cloud Build + Cloud Build SYNOPSIS gcloud beta builds triggers update github (TRIGGER : --region=REGION) @@ -20,7 +20,7 @@ SYNOPSIS --repo-name=REPO_NAME --repo-owner=REPO_OWNER) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Update GitHub trigger used by Google Cloud Build. + (BETA) Update GitHub trigger used by Cloud Build. EXAMPLES To update the branch pattern of the trigger: diff --git a/gcloud/beta/builds/triggers/update/gitlab b/gcloud/beta/builds/triggers/update/gitlab index 6e122e903..b9e01f028 100644 --- a/gcloud/beta/builds/triggers/update/gitlab +++ b/gcloud/beta/builds/triggers/update/gitlab @@ -1,6 +1,6 @@ NAME gcloud beta builds triggers update gitlab - updates GitLab trigger used by - Google Cloud Build + Cloud Build SYNOPSIS gcloud beta builds triggers update gitlab (TRIGGER : --region=REGION) @@ -17,7 +17,7 @@ SYNOPSIS | --update-substitutions=[KEY=VALUE,...]) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Updates GitLab trigger used by Google Cloud Build. + (BETA) Updates GitLab trigger used by Cloud Build. EXAMPLES To update the branch pattern of the trigger: diff --git a/gcloud/beta/builds/triggers/update/help b/gcloud/beta/builds/triggers/update/help index f96ab796e..fbf2bf5db 100644 --- a/gcloud/beta/builds/triggers/update/help +++ b/gcloud/beta/builds/triggers/update/help @@ -16,26 +16,25 @@ COMMANDS COMMAND is one of the following: bitbucketserver - (BETA) Updates Bitbucket Server trigger used by Google Cloud Build. + (BETA) Updates Bitbucket Server trigger used by Cloud Build. cloud-source-repositories - (BETA) Updates Cloud Source Repositories trigger used by Google Cloud - Build. + (BETA) Updates Cloud Source Repositories trigger used by Cloud Build. github - (BETA) Update GitHub trigger used by Google Cloud Build. + (BETA) Update GitHub trigger used by Cloud Build. gitlab - (BETA) Updates GitLab trigger used by Google Cloud Build. + (BETA) Updates GitLab trigger used by Cloud Build. manual - (BETA) Updates a manual trigger used by Google Cloud Build. + (BETA) Updates a manual trigger used by Cloud Build. pubsub - (BETA) Update a Pub/Sub trigger used by Google Cloud Build. + (BETA) Update a Pub/Sub trigger used by Cloud Build. webhook - (BETA) Update a Webhook trigger used by Google Cloud Build. + (BETA) Update a Webhook trigger used by Cloud Build. NOTES This command is currently in beta and might change without notice. These diff --git a/gcloud/beta/builds/triggers/update/manual b/gcloud/beta/builds/triggers/update/manual index 228ee6fc9..79021f35a 100644 --- a/gcloud/beta/builds/triggers/update/manual +++ b/gcloud/beta/builds/triggers/update/manual @@ -1,6 +1,6 @@ NAME gcloud beta builds triggers update manual - updates a manual trigger used - by Google Cloud Build + by Cloud Build SYNOPSIS gcloud beta builds triggers update manual (TRIGGER : --region=REGION) @@ -17,7 +17,7 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Updates a manual trigger used by Google Cloud Build. + (BETA) Updates a manual trigger used by Cloud Build. EXAMPLES To update the branch from which the trigger clones: diff --git a/gcloud/beta/builds/triggers/update/pubsub b/gcloud/beta/builds/triggers/update/pubsub index a25fe3d2c..085a2bc14 100644 --- a/gcloud/beta/builds/triggers/update/pubsub +++ b/gcloud/beta/builds/triggers/update/pubsub @@ -1,6 +1,6 @@ NAME gcloud beta builds triggers update pubsub - update a Pub/Sub trigger used - by Google Cloud Build + by Cloud Build SYNOPSIS gcloud beta builds triggers update pubsub (TRIGGER : --region=REGION) @@ -18,7 +18,7 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Update a Pub/Sub trigger used by Google Cloud Build. + (BETA) Update a Pub/Sub trigger used by Cloud Build. EXAMPLES To update the branch from which the trigger clones: diff --git a/gcloud/beta/builds/triggers/update/webhook b/gcloud/beta/builds/triggers/update/webhook index 01e417680..85a3b52ff 100644 --- a/gcloud/beta/builds/triggers/update/webhook +++ b/gcloud/beta/builds/triggers/update/webhook @@ -1,6 +1,6 @@ NAME gcloud beta builds triggers update webhook - update a Webhook trigger used - by Google Cloud Build + by Cloud Build SYNOPSIS gcloud beta builds triggers update webhook (TRIGGER : --region=REGION) @@ -18,7 +18,7 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Update a Webhook trigger used by Google Cloud Build. + (BETA) Update a Webhook trigger used by Cloud Build. EXAMPLES To update the branch from which the trigger clones: diff --git a/gcloud/beta/builds/worker-pools/create b/gcloud/beta/builds/worker-pools/create index 5afa4face..7ca2dbfb0 100644 --- a/gcloud/beta/builds/worker-pools/create +++ b/gcloud/beta/builds/worker-pools/create @@ -1,6 +1,6 @@ NAME gcloud beta builds worker-pools create - create a worker pool for use by - Google Cloud Build + Cloud Build SYNOPSIS gcloud beta builds worker-pools create WORKER_POOL --region=REGION @@ -10,7 +10,7 @@ SYNOPSIS --worker-machine-type=WORKER_MACHINE_TYPE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Create a worker pool for use by Google Cloud Build. + (BETA) Create a worker pool for use by Cloud Build. EXAMPLES To create a worker pool named wp1 in region us-central1, run: diff --git a/gcloud/beta/builds/worker-pools/describe b/gcloud/beta/builds/worker-pools/describe index 5f31e186f..a71eca523 100644 --- a/gcloud/beta/builds/worker-pools/describe +++ b/gcloud/beta/builds/worker-pools/describe @@ -1,13 +1,13 @@ NAME gcloud beta builds worker-pools describe - describe a worker pool used by - Google Cloud Build + Cloud Build SYNOPSIS gcloud beta builds worker-pools describe WORKER_POOL --region=REGION [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Describe a worker pool used by Google Cloud Build. + (BETA) Describe a worker pool used by Cloud Build. EXAMPLES To get information about a worker pool named wp1 in region us-central1, diff --git a/gcloud/beta/builds/worker-pools/help b/gcloud/beta/builds/worker-pools/help index e045d27d5..32396689b 100644 --- a/gcloud/beta/builds/worker-pools/help +++ b/gcloud/beta/builds/worker-pools/help @@ -17,19 +17,19 @@ COMMANDS COMMAND is one of the following: create - (BETA) Create a worker pool for use by Google Cloud Build. + (BETA) Create a worker pool for use by Cloud Build. delete (BETA) Delete a worker pool from Google Cloud Build. describe - (BETA) Describe a worker pool used by Google Cloud Build. + (BETA) Describe a worker pool used by Cloud Build. list (BETA) List all worker pools in a Google Cloud project. update - (BETA) Update a worker pool used by Google Cloud Build. + (BETA) Update a worker pool used by Cloud Build. NOTES This command is currently in beta and might change without notice. These diff --git a/gcloud/beta/builds/worker-pools/update b/gcloud/beta/builds/worker-pools/update index 824bacd5f..e31d7060c 100644 --- a/gcloud/beta/builds/worker-pools/update +++ b/gcloud/beta/builds/worker-pools/update @@ -1,6 +1,6 @@ NAME - gcloud beta builds worker-pools update - update a worker pool used by - Google Cloud Build + gcloud beta builds worker-pools update - update a worker pool used by Cloud + Build SYNOPSIS gcloud beta builds worker-pools update WORKER_POOL --region=REGION @@ -9,7 +9,7 @@ SYNOPSIS --worker-machine-type=WORKER_MACHINE_TYPE) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Update a worker pool used by Google Cloud Build. + (BETA) Update a worker pool used by Cloud Build. EXAMPLES To change the machine type and disk size of workers in a worker pool named diff --git a/gcloud/beta/compute/instance-groups/managed/create b/gcloud/beta/compute/instance-groups/managed/create index 93dea2634..15e41a2e8 100644 --- a/gcloud/beta/compute/instance-groups/managed/create +++ b/gcloud/beta/compute/instance-groups/managed/create @@ -5,6 +5,7 @@ NAME SYNOPSIS gcloud beta compute instance-groups managed create NAME --size=SIZE --template=TEMPLATE [--base-instance-name=BASE_INSTANCE_NAME] + [--default-action-on-vm-failure=ACTION_ON_VM_FAILURE] [--description=DESCRIPTION] [--[no-]force-update-on-repair] [--initial-delay=INITIAL_DELAY] [--instance-redistribution-type=TYPE] [--list-managed-instances-results=MODE] @@ -72,6 +73,17 @@ OPTIONAL FLAGS with the managed instance group. If not provided base instance name will be the prefix of instance group name. + --default-action-on-vm-failure=ACTION_ON_VM_FAILURE + Specifies the action that a MIG performs on a failed or an unhealthy + VM. A VM is marked as unhealthy when the application running on that VM + fails a health check. By default, the value of the flag is set to + repair. ACTION_ON_VM_FAILURE must be one of: + + do-nothing + MIG does not repair a failed or an unhealthy VM. + repair + MIG automatically repairs a failed or an unhealthy VM. + --description=DESCRIPTION An optional description for this group. diff --git a/gcloud/beta/compute/instance-groups/managed/update b/gcloud/beta/compute/instance-groups/managed/update index 1c83b792e..256672d29 100644 --- a/gcloud/beta/compute/instance-groups/managed/update +++ b/gcloud/beta/compute/instance-groups/managed/update @@ -4,6 +4,7 @@ NAME SYNOPSIS gcloud beta compute instance-groups managed update NAME + [--default-action-on-vm-failure=ACTION_ON_VM_FAILURE] [--description=DESCRIPTION] [--[no-]force-update-on-repair] [--instance-redistribution-type=TYPE] [--list-managed-instances-results=MODE] @@ -61,6 +62,17 @@ POSITIONAL ARGUMENTS Name of the managed instance group to update. FLAGS + --default-action-on-vm-failure=ACTION_ON_VM_FAILURE + Specifies the action that a MIG performs on a failed or an unhealthy + VM. A VM is marked as unhealthy when the application running on that VM + fails a health check. By default, the value of the flag is set to + repair. ACTION_ON_VM_FAILURE must be one of: + + do-nothing + MIG does not repair a failed or an unhealthy VM. + repair + MIG automatically repairs a failed or an unhealthy VM. + --description=DESCRIPTION An optional description for this group. To clear the description, set the value to an empty string. diff --git a/gcloud/beta/compute/snapshots/create b/gcloud/beta/compute/snapshots/create index a56731a76..ccfcd511e 100644 --- a/gcloud/beta/compute/snapshots/create +++ b/gcloud/beta/compute/snapshots/create @@ -6,6 +6,8 @@ SYNOPSIS [--chain-name=CHAIN_NAME] [--csek-key-file=FILE] [--description=DESCRIPTION] [--guest-flush] [--labels=[KEY=VALUE,...]] [--snapshot-type=SNAPSHOT_TYPE] [--source-disk=SOURCE_DISK] + [--source-disk-for-recovery-checkpoint=SOURCE_DISK_FOR_RECOVERY_CHECKPOINT] + [--source-disk-for-recovery-checkpoint-region=SOURCE_DISK_FOR_RECOVERY_CHECKPOINT_REGION] [--source-disk-key-file=FILE] [--source-instant-snapshot=SOURCE_INSTANT_SNAPSHOT] [--source-instant-snapshot-key-file=FILE] [--storage-location=LOCATION] @@ -81,6 +83,17 @@ FLAGS disk. For example: https://www.googleapis.com/compute/v1/projects/MY-PROJECT/zones/MY-ZONE/disks/MY-DISK + --source-disk-for-recovery-checkpoint=SOURCE_DISK_FOR_RECOVERY_CHECKPOINT + Source disk whose recovery checkpoint used to create the snapshot. To + create a snapshot from the recovery checkpoint of a source disk in a + different project, specify the full path to the source disk. For + example: projects/MY-PROJECT/regions/MY-REGION/disks/MY-DISK + + --source-disk-for-recovery-checkpoint-region=SOURCE_DISK_FOR_RECOVERY_CHECKPOINT_REGION + Region of the source disk for recovery checkpoint to operate on. + Overrides the default compute/region property value for this command + invocation. + --source-disk-key-file=FILE Path to the customer-supplied encryption key of the source disk. Required if the source disk is protected by a customer-supplied diff --git a/gcloud/beta/config/get b/gcloud/beta/config/get index f742ca7e1..fb790062b 100644 --- a/gcloud/beta/config/get +++ b/gcloud/beta/config/get @@ -298,10 +298,6 @@ AVAILABLE PROPERTIES Private Service Connect usage, see https://cloud.google.com/vpc/docs/configure-private-service-connect-apis#using-endpoints - config - Overrides API endpoint for gcloud blueprints command group. - Defaults to https://config.googleapis.com/ - container Overrides API endpoint for gcloud container command group. Defaults to https://container.googleapis.com/ @@ -382,10 +378,6 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud firestore command group. Defaults to https://firestore.googleapis.com/ - gameservices - Overrides API endpoint for gcloud gamer command group. Defaults to - https://gameservices.googleapis.com/ - genomics Overrides API endpoint for gcloud genomics command group. Defaults to https://genomics.googleapis.com/ @@ -920,24 +912,6 @@ AVAILABLE PROPERTIES fall back to this value, if set. To see valid choices, run gcloud beta functions regions list. - game_services - default_deployment - Default deployment to use when working with Cloud Game Services - list configs. When a --deployment flag is required in a list - command but not provided, the command will fall back to this value - which envokes aggregated list from the backend. - - default_realm - Default realm to use when working with Cloud Game Services list - clusters. When a --realm flag is required in a list command but not - provided, the command will fall back to this value which envokes - aggregated list from the backend. - - location - Default location to use when working with Cloud Game Services - resources. When a --location flag is required but not provided, the - command will fall back to this value. - gcloudignore enabled If True, do not upload .gcloudignore files (see $ gcloud topic diff --git a/gcloud/beta/config/help b/gcloud/beta/config/help index 75c5ccadf..8863decea 100644 --- a/gcloud/beta/config/help +++ b/gcloud/beta/config/help @@ -330,10 +330,6 @@ AVAILABLE PROPERTIES Private Service Connect usage, see https://cloud.google.com/vpc/docs/configure-private-service-connect-apis#using-endpoints - config - Overrides API endpoint for gcloud blueprints command group. - Defaults to https://config.googleapis.com/ - container Overrides API endpoint for gcloud container command group. Defaults to https://container.googleapis.com/ @@ -414,10 +410,6 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud firestore command group. Defaults to https://firestore.googleapis.com/ - gameservices - Overrides API endpoint for gcloud gamer command group. Defaults to - https://gameservices.googleapis.com/ - genomics Overrides API endpoint for gcloud genomics command group. Defaults to https://genomics.googleapis.com/ @@ -952,24 +944,6 @@ AVAILABLE PROPERTIES fall back to this value, if set. To see valid choices, run gcloud beta functions regions list. - game_services - default_deployment - Default deployment to use when working with Cloud Game Services - list configs. When a --deployment flag is required in a list - command but not provided, the command will fall back to this value - which envokes aggregated list from the backend. - - default_realm - Default realm to use when working with Cloud Game Services list - clusters. When a --realm flag is required in a list command but not - provided, the command will fall back to this value which envokes - aggregated list from the backend. - - location - Default location to use when working with Cloud Game Services - resources. When a --location flag is required but not provided, the - command will fall back to this value. - gcloudignore enabled If True, do not upload .gcloudignore files (see $ gcloud topic diff --git a/gcloud/beta/config/list b/gcloud/beta/config/list index ea098a58e..f01d69688 100644 --- a/gcloud/beta/config/list +++ b/gcloud/beta/config/list @@ -342,10 +342,6 @@ AVAILABLE PROPERTIES Private Service Connect usage, see https://cloud.google.com/vpc/docs/configure-private-service-connect-apis#using-endpoints - config - Overrides API endpoint for gcloud blueprints command group. - Defaults to https://config.googleapis.com/ - container Overrides API endpoint for gcloud container command group. Defaults to https://container.googleapis.com/ @@ -426,10 +422,6 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud firestore command group. Defaults to https://firestore.googleapis.com/ - gameservices - Overrides API endpoint for gcloud gamer command group. Defaults to - https://gameservices.googleapis.com/ - genomics Overrides API endpoint for gcloud genomics command group. Defaults to https://genomics.googleapis.com/ @@ -964,24 +956,6 @@ AVAILABLE PROPERTIES fall back to this value, if set. To see valid choices, run gcloud beta functions regions list. - game_services - default_deployment - Default deployment to use when working with Cloud Game Services - list configs. When a --deployment flag is required in a list - command but not provided, the command will fall back to this value - which envokes aggregated list from the backend. - - default_realm - Default realm to use when working with Cloud Game Services list - clusters. When a --realm flag is required in a list command but not - provided, the command will fall back to this value which envokes - aggregated list from the backend. - - location - Default location to use when working with Cloud Game Services - resources. When a --location flag is required but not provided, the - command will fall back to this value. - gcloudignore enabled If True, do not upload .gcloudignore files (see $ gcloud topic diff --git a/gcloud/beta/config/set b/gcloud/beta/config/set index bdb4524b4..28ed02620 100644 --- a/gcloud/beta/config/set +++ b/gcloud/beta/config/set @@ -345,10 +345,6 @@ AVAILABLE PROPERTIES Private Service Connect usage, see https://cloud.google.com/vpc/docs/configure-private-service-connect-apis#using-endpoints - config - Overrides API endpoint for gcloud blueprints command group. - Defaults to https://config.googleapis.com/ - container Overrides API endpoint for gcloud container command group. Defaults to https://container.googleapis.com/ @@ -429,10 +425,6 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud firestore command group. Defaults to https://firestore.googleapis.com/ - gameservices - Overrides API endpoint for gcloud gamer command group. Defaults to - https://gameservices.googleapis.com/ - genomics Overrides API endpoint for gcloud genomics command group. Defaults to https://genomics.googleapis.com/ @@ -967,24 +959,6 @@ AVAILABLE PROPERTIES fall back to this value, if set. To see valid choices, run gcloud beta functions regions list. - game_services - default_deployment - Default deployment to use when working with Cloud Game Services - list configs. When a --deployment flag is required in a list - command but not provided, the command will fall back to this value - which envokes aggregated list from the backend. - - default_realm - Default realm to use when working with Cloud Game Services list - clusters. When a --realm flag is required in a list command but not - provided, the command will fall back to this value which envokes - aggregated list from the backend. - - location - Default location to use when working with Cloud Game Services - resources. When a --location flag is required but not provided, the - command will fall back to this value. - gcloudignore enabled If True, do not upload .gcloudignore files (see $ gcloud topic diff --git a/gcloud/beta/config/unset b/gcloud/beta/config/unset index a84a5ba34..fe5366109 100644 --- a/gcloud/beta/config/unset +++ b/gcloud/beta/config/unset @@ -306,10 +306,6 @@ AVAILABLE PROPERTIES Private Service Connect usage, see https://cloud.google.com/vpc/docs/configure-private-service-connect-apis#using-endpoints - config - Overrides API endpoint for gcloud blueprints command group. - Defaults to https://config.googleapis.com/ - container Overrides API endpoint for gcloud container command group. Defaults to https://container.googleapis.com/ @@ -390,10 +386,6 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud firestore command group. Defaults to https://firestore.googleapis.com/ - gameservices - Overrides API endpoint for gcloud gamer command group. Defaults to - https://gameservices.googleapis.com/ - genomics Overrides API endpoint for gcloud genomics command group. Defaults to https://genomics.googleapis.com/ @@ -928,24 +920,6 @@ AVAILABLE PROPERTIES fall back to this value, if set. To see valid choices, run gcloud beta functions regions list. - game_services - default_deployment - Default deployment to use when working with Cloud Game Services - list configs. When a --deployment flag is required in a list - command but not provided, the command will fall back to this value - which envokes aggregated list from the backend. - - default_realm - Default realm to use when working with Cloud Game Services list - clusters. When a --realm flag is required in a list command but not - provided, the command will fall back to this value which envokes - aggregated list from the backend. - - location - Default location to use when working with Cloud Game Services - resources. When a --location flag is required but not provided, the - command will fall back to this value. - gcloudignore enabled If True, do not upload .gcloudignore files (see $ gcloud topic diff --git a/gcloud/beta/container/fleet/help b/gcloud/beta/container/fleet/help index e7edd223a..4580c63db 100644 --- a/gcloud/beta/container/fleet/help +++ b/gcloud/beta/container/fleet/help @@ -73,6 +73,9 @@ GROUPS multi-cluster-services (BETA) Manage Multi-cluster Services Feature. + policycontroller + (BETA) Manage Policy Controller Feature. + scopes (BETA) Manage scopes of all your GKE fleets. diff --git a/gcloud/beta/container/fleet/identity-service/apply b/gcloud/beta/container/fleet/identity-service/apply index f2cf19148..79640376b 100644 --- a/gcloud/beta/container/fleet/identity-service/apply +++ b/gcloud/beta/container/fleet/identity-service/apply @@ -3,8 +3,9 @@ NAME Service Feature Spec SYNOPSIS - gcloud beta container fleet identity-service apply --config=CONFIG - [--membership=MEMBERSHIP : --location=LOCATION] [GCLOUD_WIDE_FLAG ...] + gcloud beta container fleet identity-service apply + ([--config=CONFIG : [--membership=MEMBERSHIP : --location=LOCATION]]) + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Applies the authentication configuration to the Identity Service @@ -15,46 +16,50 @@ DESCRIPTION you run this command. EXAMPLES - To apply an Identity Service configuration for a membership, run: + To apply an Identity Service configuration to a membership, run: $ gcloud beta container fleet identity-service apply \ --membership=MEMBERSHIP_NAME \ --config=/path/to/identity-service.yaml REQUIRED FLAGS - --config=CONFIG - The path to the identity-service.yaml config file. + At least one of these must be specified: -OPTIONAL FLAGS - Membership resource - The group of arguments defining a membership. 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 --membership on the command line with a fully - specified name; - ◆ provide the argument --project on the command line; - ◆ set the property core/project. - - --membership=MEMBERSHIP - ID of the membership or fully qualified identifier for the - membership. - - To set the membership attribute: - ▸ provide the argument --membership on the command line. + --config=CONFIG + The path to an identity-service.yaml config file. This flag argument must be specified if any of the other arguments in this group are specified. - --location=LOCATION - Location for the membership. + Membership resource - The group of arguments defining a membership. 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 location attribute: - ▸ provide the argument --membership on the command line with a - fully specified name; - ▸ provide the argument --location on the command line; - ▸ set the property gkehub/location. + To set the project attribute: + ▸ provide the argument --membership on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --membership=MEMBERSHIP + ID of the membership or fully qualified identifier for the + membership. + + To set the membership attribute: + ▫ provide the argument --membership on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the membership. + + To set the location attribute: + ▫ provide the argument --membership on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/container/fleet/policycontroller/content/bundles/help b/gcloud/beta/container/fleet/policycontroller/content/bundles/help new file mode 100644 index 000000000..bcdcfa1a6 --- /dev/null +++ b/gcloud/beta/container/fleet/policycontroller/content/bundles/help @@ -0,0 +1,31 @@ +NAME + gcloud beta container fleet policycontroller content bundles - manage + Policy Controller content bundles + +SYNOPSIS + gcloud beta container fleet policycontroller content bundles COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Policy Controller content bundles. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + remove + (BETA) Removes a bundle installation for Policy Controller content. + + set + (BETA) Sets bundle installation for Policy Controller content. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha container fleet policycontroller content bundles + diff --git a/gcloud/beta/container/fleet/policycontroller/content/bundles/remove b/gcloud/beta/container/fleet/policycontroller/content/bundles/remove new file mode 100644 index 000000000..c716972f1 --- /dev/null +++ b/gcloud/beta/container/fleet/policycontroller/content/bundles/remove @@ -0,0 +1,79 @@ +NAME + gcloud beta container fleet policycontroller content bundles remove - + removes a bundle installation for Policy Controller content + +SYNOPSIS + gcloud beta container fleet policycontroller content bundles remove + BUNDLE_NAME + [--all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Google-defined policy bundles of constraints can be installed onto + Policy Controller installations. This command removes those bundles. + +EXAMPLES + To remove a policy bundle: + + $ gcloud beta container fleet policycontroller content bundles \ + remove cis-k8s-v1.5.1 + +POSITIONAL ARGUMENTS + BUNDLE_NAME + The constraint bundle to remove from Policy Controller. + +FLAGS + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▸ provide the argument --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha container fleet policycontroller content bundles \ + remove + diff --git a/gcloud/beta/container/fleet/policycontroller/content/bundles/set b/gcloud/beta/container/fleet/policycontroller/content/bundles/set new file mode 100644 index 000000000..ec23d2e63 --- /dev/null +++ b/gcloud/beta/container/fleet/policycontroller/content/bundles/set @@ -0,0 +1,110 @@ +NAME + gcloud beta container fleet policycontroller content bundles set - sets + bundle installation for Policy Controller content + +SYNOPSIS + gcloud beta container fleet policycontroller content bundles set + BUNDLE_NAME + [--all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [--exempted-namespaces=EXEMPTED_NAMESPACES | --no-exempted-namespaces] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Google-defined policy bundles of constraints can be installed onto + Policy Controller installations. + + The namespace exclusion flag (--exempted-namespaces) will specify a set of + namespaces that the installed bundle will ignore. Subsequent calls with the + same bundle name and this flag will overwrite what namespaces are being + ignored. Using --no-exempted-namespaces or specifying no namespaces with + --exempted-namespaces will remove all namespaces from the ignore list. + + To uninstall a bundle, use the remove command. + +EXAMPLES + To install a policy bundle: + + $ gcloud beta container fleet policycontroller content bundles set \ + cis-k8s-v1.5.1 + + To install a policy bundle, while ignoring (exempting) certain namespaces + from being affected by the bundle: + + $ gcloud beta container fleet policycontroller content bundles set \ + cis-k8s-v1.5.1 \ + --exempted-namespaces=kube-system,gatekeeper-system + + To remove all exempted namespaces from a particular bundles ignore list: + + $ gcloud beta container fleet policycontroller content bundles set \ + cis-k8s-v1.5.1 --no-exempted-namespaces + +POSITIONAL ARGUMENTS + BUNDLE_NAME + The constraint bundle to install in Policy Controller. + +FLAGS + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▸ provide the argument --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. + + Exempted Namespaces flags. + + At most one of these can be specified: + + --exempted-namespaces=EXEMPTED_NAMESPACES + Exempted namespaces are ignored by Policy Controller when applying + constraints added by this bundle. + + --no-exempted-namespaces + Removes all exempted namespaces from the specified 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 beta and might change without notice. This + variant is also available: + + $ gcloud alpha container fleet policycontroller content bundles set + diff --git a/gcloud/beta/container/fleet/policycontroller/content/help b/gcloud/beta/container/fleet/policycontroller/content/help new file mode 100644 index 000000000..a8281b898 --- /dev/null +++ b/gcloud/beta/container/fleet/policycontroller/content/help @@ -0,0 +1,31 @@ +NAME + gcloud beta container fleet policycontroller content - manage Policy + Controller content + +SYNOPSIS + gcloud beta container fleet policycontroller content GROUP + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Policy Controller content. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + bundles + (BETA) Manage Policy Controller content bundles. + + templates + (BETA) Manage Policy Controller content templates. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha container fleet policycontroller content + diff --git a/gcloud/beta/container/fleet/policycontroller/content/templates/disable b/gcloud/beta/container/fleet/policycontroller/content/templates/disable new file mode 100644 index 000000000..19ad37347 --- /dev/null +++ b/gcloud/beta/container/fleet/policycontroller/content/templates/disable @@ -0,0 +1,74 @@ +NAME + gcloud beta container fleet policycontroller content templates disable - + disable template installation for Policy Controller content + +SYNOPSIS + gcloud beta container fleet policycontroller content templates disable + [--all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) The Google-defined template library can be installed onto Policy + Controller installations. This command removes that template library. + +EXAMPLES + To remove the template library: + + $ gcloud beta container fleet policycontroller content templates \ + disable + +FLAGS + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▸ provide the argument --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha container fleet policycontroller content templates \ + disable + diff --git a/gcloud/beta/container/fleet/policycontroller/content/templates/enable b/gcloud/beta/container/fleet/policycontroller/content/templates/enable new file mode 100644 index 000000000..878f17ba5 --- /dev/null +++ b/gcloud/beta/container/fleet/policycontroller/content/templates/enable @@ -0,0 +1,75 @@ +NAME + gcloud beta container fleet policycontroller content templates enable - + installs the template library for Policy Controller + +SYNOPSIS + gcloud beta container fleet policycontroller content templates enable + [--all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Google-defined template library can be installed onto Policy + Controller installations. To uninstall the template library, use the + disable command. + +EXAMPLES + To install a template library: + + $ gcloud beta container fleet policycontroller content templates \ + enable + +FLAGS + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▸ provide the argument --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha container fleet policycontroller content templates \ + enable + diff --git a/gcloud/beta/container/fleet/policycontroller/content/templates/help b/gcloud/beta/container/fleet/policycontroller/content/templates/help new file mode 100644 index 000000000..105f05cec --- /dev/null +++ b/gcloud/beta/container/fleet/policycontroller/content/templates/help @@ -0,0 +1,31 @@ +NAME + gcloud beta container fleet policycontroller content templates - manage + Policy Controller content templates + +SYNOPSIS + gcloud beta container fleet policycontroller content templates COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Policy Controller content templates. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + disable + (BETA) Disable template installation for Policy Controller content. + + enable + (BETA) Installs the template library for Policy Controller. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha container fleet policycontroller content templates + diff --git a/gcloud/beta/container/fleet/policycontroller/deployment/help b/gcloud/beta/container/fleet/policycontroller/deployment/help new file mode 100644 index 000000000..71b13cf45 --- /dev/null +++ b/gcloud/beta/container/fleet/policycontroller/deployment/help @@ -0,0 +1,32 @@ +NAME + gcloud beta container fleet policycontroller deployment - configure Policy + Controller component deployments + +SYNOPSIS + gcloud beta container fleet policycontroller deployment COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Configure Policy Controller component deployments. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + remove + (BETA) Removes configuration properties from Policy Controller + components. + + set + (BETA) Sets configuration of the Policy Controller components. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha container fleet policycontroller deployment + diff --git a/gcloud/beta/container/fleet/policycontroller/deployment/remove b/gcloud/beta/container/fleet/policycontroller/deployment/remove new file mode 100644 index 000000000..682f55893 --- /dev/null +++ b/gcloud/beta/container/fleet/policycontroller/deployment/remove @@ -0,0 +1,136 @@ +NAME + gcloud beta container fleet policycontroller deployment remove - removes + configuration properties from Policy Controller components + +SYNOPSIS + gcloud beta container fleet policycontroller deployment remove DEPLOYMENT + PROPERTY [VALUE] [--effect=EFFECT] + [--all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Remove customizations of on-cluster components in Policy Controller. + These components are managed as individual kubernetes deployments (e.g. + 'admission') in the gatekeeper-system namespace. + + When removing a 'toleration' property, it must match exactly, including the + key, value and effect flag (if originally specified). + +EXAMPLES + To remove the replica count for a component: + + $ gcloud beta container fleet policycontroller deployment remove \ + admission replica-count + + To remove the replica count for a component across all fleet memberships: + + $ gcloud beta container fleet policycontroller deployment remove \ + admission replica-count --all-memberships + + To remove a toleration with key 'my-key' on a component: + + $ gcloud beta container fleet policycontroller deployment remove \ + admission toleration my-key + + To remove a toleration with key 'my-key' and 'my-value' on a component: + + $ gcloud beta container fleet policycontroller deployment remove \ + admission toleration my-key=my-value + + To remove a toleration with key 'my-key' and 'my-value' on a component, + along with the effect 'NoSchedule': + + $ gcloud beta container fleet policycontroller deployment remove \ + admission toleration my-key=my-value --effect=NoSchedule + + To remove a memory limit: + + $ gcloud beta container fleet policycontroller deployment remove \ + audit memory-limit + + To remove a memory request: + + $ gcloud beta container fleet policycontroller deployment remove \ + mutation memory-request + + To remove a cpu limit: + + $ gcloud beta container fleet policycontroller deployment remove \ + admission cpu-limit + + To remove a cpu request: + + $ gcloud beta container fleet policycontroller deployment remove \ + audit cpu-request + +POSITIONAL ARGUMENTS + DEPLOYMENT + The PolicyController deployment component (i.e, "admission", "audit" or + "mutation" from which to remove configuration. + + PROPERTY + Property to be removed. + + [VALUE] + This is only required to remove a toleration. It should not be included + for any other property. + +FLAGS + --effect=EFFECT + Applies only to "toleration" property. To be removed, tolerations must + match exactly, including the effect setting. EFFECT must be one of: + NoSchedule, PreferNoSchedule, NoExecute. + + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▸ provide the argument --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha container fleet policycontroller deployment remove + diff --git a/gcloud/beta/container/fleet/policycontroller/deployment/set b/gcloud/beta/container/fleet/policycontroller/deployment/set new file mode 100644 index 000000000..502a12103 --- /dev/null +++ b/gcloud/beta/container/fleet/policycontroller/deployment/set @@ -0,0 +1,143 @@ +NAME + gcloud beta container fleet policycontroller deployment set - sets + configuration of the Policy Controller components + +SYNOPSIS + gcloud beta container fleet policycontroller deployment set DEPLOYMENT + PROPERTY VALUE [--effect=EFFECT] + [--all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Customizes on-cluster components of Policy Controller. Supported + properties may be set with this command, or removed with 'remove'. These + components are managed as individual kubernetes deployments (e.g. + 'admission') in the gatekeeper-system namespace. + + When setting cpu or memory limits and requests, Kubernetes-standard + resource units are used. + + All properties set using this command will overwrite previous properties, + with the exception of tolerations which can only be added, and any number + may be added. To edit a toleration, use 'remove' to first delete it, and + then 'set' the desired toleration. + +EXAMPLES + To set the replica count for a component: + + $ gcloud beta container fleet policycontroller deployment set \ + admission replica-count 3 + + To set the replica count for a component across all fleet memberships: + + $ gcloud beta container fleet policycontroller deployment set \ + admission replica-count 3 --all-memberships + + To set a toleration with key 'my-key' on a component (which is an 'Exists' + operator): + + $ gcloud beta container fleet policycontroller deployment set \ + admission toleration my-key + + To set a toleration with key 'my-key' and 'my-value' on a component (which + is an 'Equal' operator): + + $ gcloud beta container fleet policycontroller deployment set \ + admission toleration my-key=my-value + + To set a toleration with key 'my-key' and 'my-value' on a component, along + with the effect 'NoSchedule' (which is an 'Equal' operator): + + $ gcloud beta container fleet policycontroller deployment set \ + admission toleration my-key=my-value --effect=NoSchedule + + To set a memory limit: + + $ gcloud beta container fleet policycontroller deployment set \ + audit memory-limit 4Gi + + To set a memory request: + + $ gcloud beta container fleet policycontroller deployment set \ + mutation memory-request 2Gi + + To set a cpu limit: + + $ gcloud beta container fleet policycontroller deployment set \ + admission cpu-limit 500m + + To set a cpu request: + + $ gcloud beta container fleet policycontroller deployment set \ + audit cpu-request 250m + +POSITIONAL ARGUMENTS + DEPLOYMENT + The PolicyController deployment component (e.g. "admission", "audit" or + "mutation") upon which to set configuration. + + PROPERTY + Property to be set. + + VALUE + The value to set the property to. Valid input varies based on the + property being set. + +FLAGS + --effect=EFFECT + Applies only to "toleration" property. EFFECT must be one of: + NoSchedule, PreferNoSchedule, NoExecute. + + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▸ provide the argument --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha container fleet policycontroller deployment set + diff --git a/gcloud/beta/container/fleet/policycontroller/describe b/gcloud/beta/container/fleet/policycontroller/describe new file mode 100644 index 000000000..cb104dfbe --- /dev/null +++ b/gcloud/beta/container/fleet/policycontroller/describe @@ -0,0 +1,68 @@ +NAME + gcloud beta container fleet policycontroller describe - describe Policy + Controller feature + +SYNOPSIS + gcloud beta container fleet policycontroller describe + [--all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [GCLOUD_WIDE_FLAG ...] + +EXAMPLES + To describe the Policy Controller feature: + + $ gcloud beta container fleet policycontroller describe + +FLAGS + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▸ provide the argument --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha container fleet policycontroller describe + diff --git a/gcloud/beta/container/fleet/policycontroller/detach b/gcloud/beta/container/fleet/policycontroller/detach new file mode 100644 index 000000000..176a638d1 --- /dev/null +++ b/gcloud/beta/container/fleet/policycontroller/detach @@ -0,0 +1,77 @@ +NAME + gcloud beta container fleet policycontroller detach - detach Policy + Controller Feature + +SYNOPSIS + gcloud beta container fleet policycontroller detach + [--all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Detaches Policy Controller. This will halt all administration of the + Policy Controller installation by the GKE Fleet. It will not uninstall it + from the cluster. To re-attach Policy Controller, use the enable command. + +EXAMPLES + To detach Policy Controller, run: + + $ gcloud beta container fleet policycontroller detach + + To re-attach Policy Controller, use the enable command: + + $ gcloud beta container fleet policycontroller enable + +FLAGS + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▸ provide the argument --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha container fleet policycontroller detach + diff --git a/gcloud/beta/container/fleet/policycontroller/disable b/gcloud/beta/container/fleet/policycontroller/disable new file mode 100644 index 000000000..27c07a27b --- /dev/null +++ b/gcloud/beta/container/fleet/policycontroller/disable @@ -0,0 +1,81 @@ +NAME + gcloud beta container fleet policycontroller disable - disable (Uninstall) + Policy Controller + +SYNOPSIS + gcloud beta container fleet policycontroller disable + [--fleet-default-member-config | --all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Uninstalls Policy Controller. + +EXAMPLES + To uninstall Policy Controller, run: + + $ gcloud beta container fleet policycontroller disable + +FLAGS + At most one of these can be specified: + + --fleet-default-member-config + Removes the fleet default configuration for policy controller. + Memberships configured with the fleet default will maintain their + current configuration. + + $ gcloud beta container fleet policycontroller disable \ + --fleet-default-member-config + + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --project on the command line; + ▫ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ◇ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ◇ provide the argument --memberships on the command line with a + fully specified name; + ◇ provide the argument --location on the command line; + ◇ set the property gkehub/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha container fleet policycontroller disable + diff --git a/gcloud/beta/container/fleet/policycontroller/enable b/gcloud/beta/container/fleet/policycontroller/enable new file mode 100644 index 000000000..545ff52f9 --- /dev/null +++ b/gcloud/beta/container/fleet/policycontroller/enable @@ -0,0 +1,179 @@ +NAME + gcloud beta container fleet policycontroller enable - enable Policy + Controller Feature + +SYNOPSIS + gcloud beta container fleet policycontroller enable + [--all-memberships | [--memberships=[MEMBERSHIPS,...] + : --location=LOCATION] --audit-interval=AUDIT_INTERVAL + --constraint-violation-limit=CONSTRAINT_VIOLATION_LIMIT + --no-default-bundles --version=VERSION --clear-exemptable-namespaces + | --exemptable-namespaces=EXEMPTABLE_NAMESPACES --log-denies + | --no-log-denies --monitoring=MONITORING + | --no-monitoring --mutation | --no-mutation --referential-rules + | --no-referential-rules + | --fleet-default-member-config=FLEET_DEFAULT_MEMBER_CONFIG + | --no-fleet-default-member-config] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Enables the Policy Controller Feature in a fleet. + +EXAMPLES + To enable the Policy Controller Feature, run: + + $ gcloud beta container fleet policycontroller enable + +FLAGS + At most one of these can be specified: + + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --project on the command line; + ▫ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ◇ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ◇ provide the argument --memberships on the command line with a + fully specified name; + ◇ provide the argument --location on the command line; + ◇ set the property gkehub/location. + + --audit-interval=AUDIT_INTERVAL + How often Policy Controller will audit resources, in seconds. + + --constraint-violation-limit=CONSTRAINT_VIOLATION_LIMIT + The number of violations stored on the constraint resource. Must be + greater than 0. + + --no-default-bundles + If set, skip installing the default bundle of policy-essentials. + + --version=VERSION + The version of Policy Controller to install; defaults to latest + version. + + Exemptable Namespace flags. + + At most one of these can be specified: + + --clear-exemptable-namespaces + Removes any namespace exemptions, enabling Policy Controller on all + namespaces. Setting this flag will overwrite currently exempted + namespaces, not append. + + --exemptable-namespaces=EXEMPTABLE_NAMESPACES + Namespaces that Policy Controller should ignore, separated by + commas if multiple are supplied. + + Log Denies flags. + + At most one of these can be specified: + + --log-denies + If set, log all denies and dry run failures. (To disable, use + --no-log-denies) + + --no-log-denies + If set, disable all log denies. + + Monitoring flags. + + At most one of these can be specified: + + --monitoring=MONITORING + Monitoring backend options Policy Controller should export metrics + to, separated by commas if multiple are supplied. Setting this flag + will overwrite currently enabled backends, not append. Options: + prometheus, cloudmonitoring + + --no-monitoring + Include this flag to disable the monitoring configuration of Policy + Controller. + + Mutation flags. + + At most one of these can be specified: + + --mutation + If set, enable support for mutation. (To disable, use + --no-mutation) + + --no-mutation + Disables mutation support. + + Referential Rules flags. + + At most one of these can be specified: + + --referential-rules + If set, enable support for referential constraints. (To disable, + use --no-referential-rules) + + --no-referential-rules + Disables referential rules support. + + Flags for setting Fleet Default Configuration files. + + At most one of these can be specified: + + --fleet-default-member-config=FLEET_DEFAULT_MEMBER_CONFIG + The path to a policy-controller.yaml configuration file. If + specified, this configuration will become the default Policy + Controller configuration for all memberships in your fleet. It can + be overridden with a membership-specific configuration by using the + the Update command. + + To enable the Policy Controller Feature with a fleet-level default + membership configuration, run: + + $ gcloud beta container fleet policycontroller enable \ + --fleet-default-member-config=/path/to/policy-controller.yaml + + --no-fleet-default-member-config + Removes the fleet default configuration for policy controller. + Memberships configured with the fleet default will maintain their + current configuration. + + $ gcloud beta container fleet policycontroller enable \ + --no-fleet-default-member-config + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha container fleet policycontroller enable + diff --git a/gcloud/beta/container/fleet/policycontroller/help b/gcloud/beta/container/fleet/policycontroller/help new file mode 100644 index 000000000..9ec917c58 --- /dev/null +++ b/gcloud/beta/container/fleet/policycontroller/help @@ -0,0 +1,52 @@ +NAME + gcloud beta container fleet policycontroller - manage Policy Controller + Feature + +SYNOPSIS + gcloud beta container fleet policycontroller GROUP | COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Policy Controller Feature. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + content + (BETA) Manage Policy Controller content. + + deployment + (BETA) Configure Policy Controller component deployments. + +COMMANDS + COMMAND is one of the following: + + describe + (BETA) Describe Policy Controller feature. + + detach + (BETA) Detach Policy Controller Feature. + + disable + (BETA) Disable (Uninstall) Policy Controller. + + enable + (BETA) Enable Policy Controller Feature. + + suspend + (BETA) Suspend Policy Controller Feature. + + update + (BETA) Updates the configuration of Policy Controller Feature. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha container fleet policycontroller + diff --git a/gcloud/beta/container/fleet/policycontroller/suspend b/gcloud/beta/container/fleet/policycontroller/suspend new file mode 100644 index 000000000..04cfaf9ea --- /dev/null +++ b/gcloud/beta/container/fleet/policycontroller/suspend @@ -0,0 +1,77 @@ +NAME + gcloud beta container fleet policycontroller suspend - suspend Policy + Controller Feature + +SYNOPSIS + gcloud beta container fleet policycontroller suspend + [--all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Suspends the Policy Controller. This will disable all kubernetes + webhooks on the configured cluster, thereby removing admission and mutation + functionality. Audit functionality will remain in place. + +EXAMPLES + To suspend Policy Controller, run: + + $ gcloud beta container fleet policycontroller suspend + + To re-enable Policy Controller webhooks, use the enable command: + + $ gcloud beta container fleet policycontroller enable + +FLAGS + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▸ provide the argument --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha container fleet policycontroller suspend + diff --git a/gcloud/beta/container/fleet/policycontroller/update b/gcloud/beta/container/fleet/policycontroller/update new file mode 100644 index 000000000..6456977ff --- /dev/null +++ b/gcloud/beta/container/fleet/policycontroller/update @@ -0,0 +1,162 @@ +NAME + gcloud beta container fleet policycontroller update - updates the + configuration of Policy Controller Feature + +SYNOPSIS + gcloud beta container fleet policycontroller update + [--all-memberships | [--memberships=[MEMBERSHIPS,...] + : --location=LOCATION] --origin=ORIGIN + | --audit-interval=AUDIT_INTERVAL + --constraint-violation-limit=CONSTRAINT_VIOLATION_LIMIT + --version=VERSION --clear-exemptable-namespaces + | --exemptable-namespaces=EXEMPTABLE_NAMESPACES --log-denies + | --no-log-denies --monitoring=MONITORING + | --no-monitoring --mutation | --no-mutation --referential-rules + | --no-referential-rules] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Updates the configuration of the Policy Controller installation + +EXAMPLES + To change the installed version, run: + + $ gcloud beta container fleet policycontroller update \ + --version=VERSION + + To modify the audit interval to 120 seconds, run: + + $ gcloud beta container fleet policycontroller update \ + --audit-interval=120 + +FLAGS + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▸ provide the argument --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. + + At most one of these can be specified: + + --origin=ORIGIN + If --origin=FLEET will set the configuration of the membership to the + fleet default. + + ORIGIN must be (only one value is supported): FLEET. + + --audit-interval=AUDIT_INTERVAL + How often Policy Controller will audit resources, in seconds. + + --constraint-violation-limit=CONSTRAINT_VIOLATION_LIMIT + The number of violations stored on the constraint resource. Must be + greater than 0. + + --version=VERSION + The version of Policy Controller to install; defaults to latest + version. + + Exemptable Namespace flags. + + At most one of these can be specified: + + --clear-exemptable-namespaces + Removes any namespace exemptions, enabling Policy Controller on all + namespaces. Setting this flag will overwrite currently exempted + namespaces, not append. + + --exemptable-namespaces=EXEMPTABLE_NAMESPACES + Namespaces that Policy Controller should ignore, separated by + commas if multiple are supplied. + + Log Denies flags. + + At most one of these can be specified: + + --log-denies + If set, log all denies and dry run failures. (To disable, use + --no-log-denies) + + --no-log-denies + If set, disable all log denies. + + Monitoring flags. + + At most one of these can be specified: + + --monitoring=MONITORING + Monitoring backend options Policy Controller should export metrics + to, separated by commas if multiple are supplied. Setting this flag + will overwrite currently enabled backends, not append. Options: + prometheus, cloudmonitoring + + --no-monitoring + Include this flag to disable the monitoring configuration of Policy + Controller. + + Mutation flags. + + At most one of these can be specified: + + --mutation + If set, enable support for mutation. (To disable, use + --no-mutation) + + --no-mutation + Disables mutation support. + + Referential Rules flags. + + At most one of these can be specified: + + --referential-rules + If set, enable support for referential constraints. (To disable, + use --no-referential-rules) + + --no-referential-rules + Disables referential rules support. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha container fleet policycontroller update + diff --git a/gcloud/beta/container/hub/help b/gcloud/beta/container/hub/help index 296973feb..a870a3dd0 100644 --- a/gcloud/beta/container/hub/help +++ b/gcloud/beta/container/hub/help @@ -73,6 +73,9 @@ GROUPS multi-cluster-services (BETA) Manage Multi-cluster Services Feature. + policycontroller + (BETA) Manage Policy Controller Feature. + scopes (BETA) Manage scopes of all your GKE fleets. diff --git a/gcloud/beta/container/hub/identity-service/apply b/gcloud/beta/container/hub/identity-service/apply index a53b04dcd..c0ebf4f47 100644 --- a/gcloud/beta/container/hub/identity-service/apply +++ b/gcloud/beta/container/hub/identity-service/apply @@ -3,8 +3,9 @@ NAME Service Feature Spec SYNOPSIS - gcloud beta container hub identity-service apply --config=CONFIG - [--membership=MEMBERSHIP : --location=LOCATION] [GCLOUD_WIDE_FLAG ...] + gcloud beta container hub identity-service apply + ([--config=CONFIG : [--membership=MEMBERSHIP : --location=LOCATION]]) + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Applies the authentication configuration to the Identity Service @@ -15,46 +16,50 @@ DESCRIPTION you run this command. EXAMPLES - To apply an Identity Service configuration for a membership, run: + To apply an Identity Service configuration to a membership, run: $ gcloud beta container hub identity-service apply \ --membership=MEMBERSHIP_NAME \ --config=/path/to/identity-service.yaml REQUIRED FLAGS - --config=CONFIG - The path to the identity-service.yaml config file. + At least one of these must be specified: -OPTIONAL FLAGS - Membership resource - The group of arguments defining a membership. 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 --membership on the command line with a fully - specified name; - ◆ provide the argument --project on the command line; - ◆ set the property core/project. - - --membership=MEMBERSHIP - ID of the membership or fully qualified identifier for the - membership. - - To set the membership attribute: - ▸ provide the argument --membership on the command line. + --config=CONFIG + The path to an identity-service.yaml config file. This flag argument must be specified if any of the other arguments in this group are specified. - --location=LOCATION - Location for the membership. + Membership resource - The group of arguments defining a membership. 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 location attribute: - ▸ provide the argument --membership on the command line with a - fully specified name; - ▸ provide the argument --location on the command line; - ▸ set the property gkehub/location. + To set the project attribute: + ▸ provide the argument --membership on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --membership=MEMBERSHIP + ID of the membership or fully qualified identifier for the + membership. + + To set the membership attribute: + ▫ provide the argument --membership on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the membership. + + To set the location attribute: + ▫ provide the argument --membership on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/container/hub/policycontroller/content/bundles/help b/gcloud/beta/container/hub/policycontroller/content/bundles/help new file mode 100644 index 000000000..b6cd7d217 --- /dev/null +++ b/gcloud/beta/container/hub/policycontroller/content/bundles/help @@ -0,0 +1,31 @@ +NAME + gcloud beta container hub policycontroller content bundles - manage Policy + Controller content bundles + +SYNOPSIS + gcloud beta container hub policycontroller content bundles COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Policy Controller content bundles. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + remove + (BETA) Removes a bundle installation for Policy Controller content. + + set + (BETA) Sets bundle installation for Policy Controller content. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha container hub policycontroller content bundles + diff --git a/gcloud/beta/container/hub/policycontroller/content/bundles/remove b/gcloud/beta/container/hub/policycontroller/content/bundles/remove new file mode 100644 index 000000000..5eccfa13a --- /dev/null +++ b/gcloud/beta/container/hub/policycontroller/content/bundles/remove @@ -0,0 +1,78 @@ +NAME + gcloud beta container hub policycontroller content bundles remove - removes + a bundle installation for Policy Controller content + +SYNOPSIS + gcloud beta container hub policycontroller content bundles remove + BUNDLE_NAME + [--all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Google-defined policy bundles of constraints can be installed onto + Policy Controller installations. This command removes those bundles. + +EXAMPLES + To remove a policy bundle: + + $ gcloud beta container hub policycontroller content bundles \ + remove cis-k8s-v1.5.1 + +POSITIONAL ARGUMENTS + BUNDLE_NAME + The constraint bundle to remove from Policy Controller. + +FLAGS + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▸ provide the argument --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha container hub policycontroller content bundles remove + diff --git a/gcloud/beta/container/hub/policycontroller/content/bundles/set b/gcloud/beta/container/hub/policycontroller/content/bundles/set new file mode 100644 index 000000000..d5ac012c7 --- /dev/null +++ b/gcloud/beta/container/hub/policycontroller/content/bundles/set @@ -0,0 +1,109 @@ +NAME + gcloud beta container hub policycontroller content bundles set - sets + bundle installation for Policy Controller content + +SYNOPSIS + gcloud beta container hub policycontroller content bundles set BUNDLE_NAME + [--all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [--exempted-namespaces=EXEMPTED_NAMESPACES | --no-exempted-namespaces] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Google-defined policy bundles of constraints can be installed onto + Policy Controller installations. + + The namespace exclusion flag (--exempted-namespaces) will specify a set of + namespaces that the installed bundle will ignore. Subsequent calls with the + same bundle name and this flag will overwrite what namespaces are being + ignored. Using --no-exempted-namespaces or specifying no namespaces with + --exempted-namespaces will remove all namespaces from the ignore list. + + To uninstall a bundle, use the remove command. + +EXAMPLES + To install a policy bundle: + + $ gcloud beta container hub policycontroller content bundles set \ + cis-k8s-v1.5.1 + + To install a policy bundle, while ignoring (exempting) certain namespaces + from being affected by the bundle: + + $ gcloud beta container hub policycontroller content bundles set \ + cis-k8s-v1.5.1 \ + --exempted-namespaces=kube-system,gatekeeper-system + + To remove all exempted namespaces from a particular bundles ignore list: + + $ gcloud beta container hub policycontroller content bundles set \ + cis-k8s-v1.5.1 --no-exempted-namespaces + +POSITIONAL ARGUMENTS + BUNDLE_NAME + The constraint bundle to install in Policy Controller. + +FLAGS + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▸ provide the argument --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. + + Exempted Namespaces flags. + + At most one of these can be specified: + + --exempted-namespaces=EXEMPTED_NAMESPACES + Exempted namespaces are ignored by Policy Controller when applying + constraints added by this bundle. + + --no-exempted-namespaces + Removes all exempted namespaces from the specified 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 beta and might change without notice. This + variant is also available: + + $ gcloud alpha container hub policycontroller content bundles set + diff --git a/gcloud/beta/container/hub/policycontroller/content/help b/gcloud/beta/container/hub/policycontroller/content/help new file mode 100644 index 000000000..fa315b6fa --- /dev/null +++ b/gcloud/beta/container/hub/policycontroller/content/help @@ -0,0 +1,31 @@ +NAME + gcloud beta container hub policycontroller content - manage Policy + Controller content + +SYNOPSIS + gcloud beta container hub policycontroller content GROUP + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Policy Controller content. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + bundles + (BETA) Manage Policy Controller content bundles. + + templates + (BETA) Manage Policy Controller content templates. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha container hub policycontroller content + diff --git a/gcloud/beta/container/hub/policycontroller/content/templates/disable b/gcloud/beta/container/hub/policycontroller/content/templates/disable new file mode 100644 index 000000000..8d79b7144 --- /dev/null +++ b/gcloud/beta/container/hub/policycontroller/content/templates/disable @@ -0,0 +1,74 @@ +NAME + gcloud beta container hub policycontroller content templates disable - + disable template installation for Policy Controller content + +SYNOPSIS + gcloud beta container hub policycontroller content templates disable + [--all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) The Google-defined template library can be installed onto Policy + Controller installations. This command removes that template library. + +EXAMPLES + To remove the template library: + + $ gcloud beta container hub policycontroller content templates \ + disable + +FLAGS + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▸ provide the argument --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha container hub policycontroller content templates \ + disable + diff --git a/gcloud/beta/container/hub/policycontroller/content/templates/enable b/gcloud/beta/container/hub/policycontroller/content/templates/enable new file mode 100644 index 000000000..40318431e --- /dev/null +++ b/gcloud/beta/container/hub/policycontroller/content/templates/enable @@ -0,0 +1,74 @@ +NAME + gcloud beta container hub policycontroller content templates enable - + installs the template library for Policy Controller + +SYNOPSIS + gcloud beta container hub policycontroller content templates enable + [--all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Google-defined template library can be installed onto Policy + Controller installations. To uninstall the template library, use the + disable command. + +EXAMPLES + To install a template library: + + $ gcloud beta container hub policycontroller content templates enable + +FLAGS + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▸ provide the argument --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha container hub policycontroller content templates \ + enable + diff --git a/gcloud/beta/container/hub/policycontroller/content/templates/help b/gcloud/beta/container/hub/policycontroller/content/templates/help new file mode 100644 index 000000000..33870bd82 --- /dev/null +++ b/gcloud/beta/container/hub/policycontroller/content/templates/help @@ -0,0 +1,31 @@ +NAME + gcloud beta container hub policycontroller content templates - manage + Policy Controller content templates + +SYNOPSIS + gcloud beta container hub policycontroller content templates COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Policy Controller content templates. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + disable + (BETA) Disable template installation for Policy Controller content. + + enable + (BETA) Installs the template library for Policy Controller. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha container hub policycontroller content templates + diff --git a/gcloud/beta/container/hub/policycontroller/deployment/help b/gcloud/beta/container/hub/policycontroller/deployment/help new file mode 100644 index 000000000..dc2355300 --- /dev/null +++ b/gcloud/beta/container/hub/policycontroller/deployment/help @@ -0,0 +1,32 @@ +NAME + gcloud beta container hub policycontroller deployment - configure Policy + Controller component deployments + +SYNOPSIS + gcloud beta container hub policycontroller deployment COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Configure Policy Controller component deployments. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + remove + (BETA) Removes configuration properties from Policy Controller + components. + + set + (BETA) Sets configuration of the Policy Controller components. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha container hub policycontroller deployment + diff --git a/gcloud/beta/container/hub/policycontroller/deployment/remove b/gcloud/beta/container/hub/policycontroller/deployment/remove new file mode 100644 index 000000000..e8dc3395a --- /dev/null +++ b/gcloud/beta/container/hub/policycontroller/deployment/remove @@ -0,0 +1,136 @@ +NAME + gcloud beta container hub policycontroller deployment remove - removes + configuration properties from Policy Controller components + +SYNOPSIS + gcloud beta container hub policycontroller deployment remove DEPLOYMENT + PROPERTY [VALUE] [--effect=EFFECT] + [--all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Remove customizations of on-cluster components in Policy Controller. + These components are managed as individual kubernetes deployments (e.g. + 'admission') in the gatekeeper-system namespace. + + When removing a 'toleration' property, it must match exactly, including the + key, value and effect flag (if originally specified). + +EXAMPLES + To remove the replica count for a component: + + $ gcloud beta container hub policycontroller deployment remove \ + admission replica-count + + To remove the replica count for a component across all fleet memberships: + + $ gcloud beta container hub policycontroller deployment remove \ + admission replica-count --all-memberships + + To remove a toleration with key 'my-key' on a component: + + $ gcloud beta container hub policycontroller deployment remove \ + admission toleration my-key + + To remove a toleration with key 'my-key' and 'my-value' on a component: + + $ gcloud beta container hub policycontroller deployment remove \ + admission toleration my-key=my-value + + To remove a toleration with key 'my-key' and 'my-value' on a component, + along with the effect 'NoSchedule': + + $ gcloud beta container hub policycontroller deployment remove \ + admission toleration my-key=my-value --effect=NoSchedule + + To remove a memory limit: + + $ gcloud beta container hub policycontroller deployment remove \ + audit memory-limit + + To remove a memory request: + + $ gcloud beta container hub policycontroller deployment remove \ + mutation memory-request + + To remove a cpu limit: + + $ gcloud beta container hub policycontroller deployment remove \ + admission cpu-limit + + To remove a cpu request: + + $ gcloud beta container hub policycontroller deployment remove \ + audit cpu-request + +POSITIONAL ARGUMENTS + DEPLOYMENT + The PolicyController deployment component (i.e, "admission", "audit" or + "mutation" from which to remove configuration. + + PROPERTY + Property to be removed. + + [VALUE] + This is only required to remove a toleration. It should not be included + for any other property. + +FLAGS + --effect=EFFECT + Applies only to "toleration" property. To be removed, tolerations must + match exactly, including the effect setting. EFFECT must be one of: + NoSchedule, PreferNoSchedule, NoExecute. + + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▸ provide the argument --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha container hub policycontroller deployment remove + diff --git a/gcloud/beta/container/hub/policycontroller/deployment/set b/gcloud/beta/container/hub/policycontroller/deployment/set new file mode 100644 index 000000000..1085774b1 --- /dev/null +++ b/gcloud/beta/container/hub/policycontroller/deployment/set @@ -0,0 +1,143 @@ +NAME + gcloud beta container hub policycontroller deployment set - sets + configuration of the Policy Controller components + +SYNOPSIS + gcloud beta container hub policycontroller deployment set DEPLOYMENT + PROPERTY VALUE [--effect=EFFECT] + [--all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Customizes on-cluster components of Policy Controller. Supported + properties may be set with this command, or removed with 'remove'. These + components are managed as individual kubernetes deployments (e.g. + 'admission') in the gatekeeper-system namespace. + + When setting cpu or memory limits and requests, Kubernetes-standard + resource units are used. + + All properties set using this command will overwrite previous properties, + with the exception of tolerations which can only be added, and any number + may be added. To edit a toleration, use 'remove' to first delete it, and + then 'set' the desired toleration. + +EXAMPLES + To set the replica count for a component: + + $ gcloud beta container hub policycontroller deployment set \ + admission replica-count 3 + + To set the replica count for a component across all fleet memberships: + + $ gcloud beta container hub policycontroller deployment set \ + admission replica-count 3 --all-memberships + + To set a toleration with key 'my-key' on a component (which is an 'Exists' + operator): + + $ gcloud beta container hub policycontroller deployment set \ + admission toleration my-key + + To set a toleration with key 'my-key' and 'my-value' on a component (which + is an 'Equal' operator): + + $ gcloud beta container hub policycontroller deployment set \ + admission toleration my-key=my-value + + To set a toleration with key 'my-key' and 'my-value' on a component, along + with the effect 'NoSchedule' (which is an 'Equal' operator): + + $ gcloud beta container hub policycontroller deployment set \ + admission toleration my-key=my-value --effect=NoSchedule + + To set a memory limit: + + $ gcloud beta container hub policycontroller deployment set audit \ + memory-limit 4Gi + + To set a memory request: + + $ gcloud beta container hub policycontroller deployment set \ + mutation memory-request 2Gi + + To set a cpu limit: + + $ gcloud beta container hub policycontroller deployment set \ + admission cpu-limit 500m + + To set a cpu request: + + $ gcloud beta container hub policycontroller deployment set audit \ + cpu-request 250m + +POSITIONAL ARGUMENTS + DEPLOYMENT + The PolicyController deployment component (e.g. "admission", "audit" or + "mutation") upon which to set configuration. + + PROPERTY + Property to be set. + + VALUE + The value to set the property to. Valid input varies based on the + property being set. + +FLAGS + --effect=EFFECT + Applies only to "toleration" property. EFFECT must be one of: + NoSchedule, PreferNoSchedule, NoExecute. + + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▸ provide the argument --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha container hub policycontroller deployment set + diff --git a/gcloud/beta/container/hub/policycontroller/describe b/gcloud/beta/container/hub/policycontroller/describe new file mode 100644 index 000000000..24318f218 --- /dev/null +++ b/gcloud/beta/container/hub/policycontroller/describe @@ -0,0 +1,68 @@ +NAME + gcloud beta container hub policycontroller describe - describe Policy + Controller feature + +SYNOPSIS + gcloud beta container hub policycontroller describe + [--all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [GCLOUD_WIDE_FLAG ...] + +EXAMPLES + To describe the Policy Controller feature: + + $ gcloud beta container hub policycontroller describe + +FLAGS + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▸ provide the argument --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha container hub policycontroller describe + diff --git a/gcloud/beta/container/hub/policycontroller/detach b/gcloud/beta/container/hub/policycontroller/detach new file mode 100644 index 000000000..f7e89ec69 --- /dev/null +++ b/gcloud/beta/container/hub/policycontroller/detach @@ -0,0 +1,77 @@ +NAME + gcloud beta container hub policycontroller detach - detach Policy + Controller Feature + +SYNOPSIS + gcloud beta container hub policycontroller detach + [--all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Detaches Policy Controller. This will halt all administration of the + Policy Controller installation by the GKE Fleet. It will not uninstall it + from the cluster. To re-attach Policy Controller, use the enable command. + +EXAMPLES + To detach Policy Controller, run: + + $ gcloud beta container hub policycontroller detach + + To re-attach Policy Controller, use the enable command: + + $ gcloud beta container hub policycontroller enable + +FLAGS + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▸ provide the argument --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha container hub policycontroller detach + diff --git a/gcloud/beta/container/hub/policycontroller/disable b/gcloud/beta/container/hub/policycontroller/disable new file mode 100644 index 000000000..c1cf2e3c6 --- /dev/null +++ b/gcloud/beta/container/hub/policycontroller/disable @@ -0,0 +1,81 @@ +NAME + gcloud beta container hub policycontroller disable - disable (Uninstall) + Policy Controller + +SYNOPSIS + gcloud beta container hub policycontroller disable + [--fleet-default-member-config | --all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Uninstalls Policy Controller. + +EXAMPLES + To uninstall Policy Controller, run: + + $ gcloud beta container hub policycontroller disable + +FLAGS + At most one of these can be specified: + + --fleet-default-member-config + Removes the fleet default configuration for policy controller. + Memberships configured with the fleet default will maintain their + current configuration. + + $ gcloud beta container hub policycontroller disable \ + --fleet-default-member-config + + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --project on the command line; + ▫ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ◇ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ◇ provide the argument --memberships on the command line with a + fully specified name; + ◇ provide the argument --location on the command line; + ◇ set the property gkehub/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha container hub policycontroller disable + diff --git a/gcloud/beta/container/hub/policycontroller/enable b/gcloud/beta/container/hub/policycontroller/enable new file mode 100644 index 000000000..148954e00 --- /dev/null +++ b/gcloud/beta/container/hub/policycontroller/enable @@ -0,0 +1,179 @@ +NAME + gcloud beta container hub policycontroller enable - enable Policy + Controller Feature + +SYNOPSIS + gcloud beta container hub policycontroller enable + [--all-memberships | [--memberships=[MEMBERSHIPS,...] + : --location=LOCATION] --audit-interval=AUDIT_INTERVAL + --constraint-violation-limit=CONSTRAINT_VIOLATION_LIMIT + --no-default-bundles --version=VERSION --clear-exemptable-namespaces + | --exemptable-namespaces=EXEMPTABLE_NAMESPACES --log-denies + | --no-log-denies --monitoring=MONITORING + | --no-monitoring --mutation | --no-mutation --referential-rules + | --no-referential-rules + | --fleet-default-member-config=FLEET_DEFAULT_MEMBER_CONFIG + | --no-fleet-default-member-config] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Enables the Policy Controller Feature in a fleet. + +EXAMPLES + To enable the Policy Controller Feature, run: + + $ gcloud beta container hub policycontroller enable + +FLAGS + At most one of these can be specified: + + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --project on the command line; + ▫ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ◇ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ◇ provide the argument --memberships on the command line with a + fully specified name; + ◇ provide the argument --location on the command line; + ◇ set the property gkehub/location. + + --audit-interval=AUDIT_INTERVAL + How often Policy Controller will audit resources, in seconds. + + --constraint-violation-limit=CONSTRAINT_VIOLATION_LIMIT + The number of violations stored on the constraint resource. Must be + greater than 0. + + --no-default-bundles + If set, skip installing the default bundle of policy-essentials. + + --version=VERSION + The version of Policy Controller to install; defaults to latest + version. + + Exemptable Namespace flags. + + At most one of these can be specified: + + --clear-exemptable-namespaces + Removes any namespace exemptions, enabling Policy Controller on all + namespaces. Setting this flag will overwrite currently exempted + namespaces, not append. + + --exemptable-namespaces=EXEMPTABLE_NAMESPACES + Namespaces that Policy Controller should ignore, separated by + commas if multiple are supplied. + + Log Denies flags. + + At most one of these can be specified: + + --log-denies + If set, log all denies and dry run failures. (To disable, use + --no-log-denies) + + --no-log-denies + If set, disable all log denies. + + Monitoring flags. + + At most one of these can be specified: + + --monitoring=MONITORING + Monitoring backend options Policy Controller should export metrics + to, separated by commas if multiple are supplied. Setting this flag + will overwrite currently enabled backends, not append. Options: + prometheus, cloudmonitoring + + --no-monitoring + Include this flag to disable the monitoring configuration of Policy + Controller. + + Mutation flags. + + At most one of these can be specified: + + --mutation + If set, enable support for mutation. (To disable, use + --no-mutation) + + --no-mutation + Disables mutation support. + + Referential Rules flags. + + At most one of these can be specified: + + --referential-rules + If set, enable support for referential constraints. (To disable, + use --no-referential-rules) + + --no-referential-rules + Disables referential rules support. + + Flags for setting Fleet Default Configuration files. + + At most one of these can be specified: + + --fleet-default-member-config=FLEET_DEFAULT_MEMBER_CONFIG + The path to a policy-controller.yaml configuration file. If + specified, this configuration will become the default Policy + Controller configuration for all memberships in your fleet. It can + be overridden with a membership-specific configuration by using the + the Update command. + + To enable the Policy Controller Feature with a fleet-level default + membership configuration, run: + + $ gcloud beta container hub policycontroller enable \ + --fleet-default-member-config=/path/to/policy-controller.yaml + + --no-fleet-default-member-config + Removes the fleet default configuration for policy controller. + Memberships configured with the fleet default will maintain their + current configuration. + + $ gcloud beta container hub policycontroller enable \ + --no-fleet-default-member-config + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha container hub policycontroller enable + diff --git a/gcloud/beta/container/hub/policycontroller/help b/gcloud/beta/container/hub/policycontroller/help new file mode 100644 index 000000000..7788a9863 --- /dev/null +++ b/gcloud/beta/container/hub/policycontroller/help @@ -0,0 +1,52 @@ +NAME + gcloud beta container hub policycontroller - manage Policy Controller + Feature + +SYNOPSIS + gcloud beta container hub policycontroller GROUP | COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Policy Controller Feature. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + content + (BETA) Manage Policy Controller content. + + deployment + (BETA) Configure Policy Controller component deployments. + +COMMANDS + COMMAND is one of the following: + + describe + (BETA) Describe Policy Controller feature. + + detach + (BETA) Detach Policy Controller Feature. + + disable + (BETA) Disable (Uninstall) Policy Controller. + + enable + (BETA) Enable Policy Controller Feature. + + suspend + (BETA) Suspend Policy Controller Feature. + + update + (BETA) Updates the configuration of Policy Controller Feature. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha container hub policycontroller + diff --git a/gcloud/beta/container/hub/policycontroller/suspend b/gcloud/beta/container/hub/policycontroller/suspend new file mode 100644 index 000000000..e2a5ef96a --- /dev/null +++ b/gcloud/beta/container/hub/policycontroller/suspend @@ -0,0 +1,77 @@ +NAME + gcloud beta container hub policycontroller suspend - suspend Policy + Controller Feature + +SYNOPSIS + gcloud beta container hub policycontroller suspend + [--all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Suspends the Policy Controller. This will disable all kubernetes + webhooks on the configured cluster, thereby removing admission and mutation + functionality. Audit functionality will remain in place. + +EXAMPLES + To suspend Policy Controller, run: + + $ gcloud beta container hub policycontroller suspend + + To re-enable Policy Controller webhooks, use the enable command: + + $ gcloud beta container hub policycontroller enable + +FLAGS + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▸ provide the argument --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha container hub policycontroller suspend + diff --git a/gcloud/beta/container/hub/policycontroller/update b/gcloud/beta/container/hub/policycontroller/update new file mode 100644 index 000000000..5f1f64054 --- /dev/null +++ b/gcloud/beta/container/hub/policycontroller/update @@ -0,0 +1,161 @@ +NAME + gcloud beta container hub policycontroller update - updates the + configuration of Policy Controller Feature + +SYNOPSIS + gcloud beta container hub policycontroller update + [--all-memberships | [--memberships=[MEMBERSHIPS,...] + : --location=LOCATION] --origin=ORIGIN + | --audit-interval=AUDIT_INTERVAL + --constraint-violation-limit=CONSTRAINT_VIOLATION_LIMIT + --version=VERSION --clear-exemptable-namespaces + | --exemptable-namespaces=EXEMPTABLE_NAMESPACES --log-denies + | --no-log-denies --monitoring=MONITORING + | --no-monitoring --mutation | --no-mutation --referential-rules + | --no-referential-rules] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Updates the configuration of the Policy Controller installation + +EXAMPLES + To change the installed version, run: + + $ gcloud beta container hub policycontroller update --version=VERSION + + To modify the audit interval to 120 seconds, run: + + $ gcloud beta container hub policycontroller update \ + --audit-interval=120 + +FLAGS + Membership flags. + + At most one of these can be specified: + + --all-memberships + If supplied, apply to all Policy Controllers memberships in the + fleet. + + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▸ provide the argument --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. + + At most one of these can be specified: + + --origin=ORIGIN + If --origin=FLEET will set the configuration of the membership to the + fleet default. + + ORIGIN must be (only one value is supported): FLEET. + + --audit-interval=AUDIT_INTERVAL + How often Policy Controller will audit resources, in seconds. + + --constraint-violation-limit=CONSTRAINT_VIOLATION_LIMIT + The number of violations stored on the constraint resource. Must be + greater than 0. + + --version=VERSION + The version of Policy Controller to install; defaults to latest + version. + + Exemptable Namespace flags. + + At most one of these can be specified: + + --clear-exemptable-namespaces + Removes any namespace exemptions, enabling Policy Controller on all + namespaces. Setting this flag will overwrite currently exempted + namespaces, not append. + + --exemptable-namespaces=EXEMPTABLE_NAMESPACES + Namespaces that Policy Controller should ignore, separated by + commas if multiple are supplied. + + Log Denies flags. + + At most one of these can be specified: + + --log-denies + If set, log all denies and dry run failures. (To disable, use + --no-log-denies) + + --no-log-denies + If set, disable all log denies. + + Monitoring flags. + + At most one of these can be specified: + + --monitoring=MONITORING + Monitoring backend options Policy Controller should export metrics + to, separated by commas if multiple are supplied. Setting this flag + will overwrite currently enabled backends, not append. Options: + prometheus, cloudmonitoring + + --no-monitoring + Include this flag to disable the monitoring configuration of Policy + Controller. + + Mutation flags. + + At most one of these can be specified: + + --mutation + If set, enable support for mutation. (To disable, use + --no-mutation) + + --no-mutation + Disables mutation support. + + Referential Rules flags. + + At most one of these can be specified: + + --referential-rules + If set, enable support for referential constraints. (To disable, + use --no-referential-rules) + + --no-referential-rules + Disables referential rules support. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha container hub policycontroller update + diff --git a/gcloud/beta/game/help b/gcloud/beta/game/help deleted file mode 100644 index 1c7fb3264..000000000 --- a/gcloud/beta/game/help +++ /dev/null @@ -1,34 +0,0 @@ -NAME - gcloud beta game - managed Cloud Game Services - -SYNOPSIS - gcloud beta game GROUP [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Managed Cloud Game Services. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -GROUPS - GROUP is one of the following: - - locations - (BETA) Query Cloud Game Services Locations. - - operations - (BETA) Deploy and manage Cloud Game Services Operations. - - servers - (BETA) Managed Cloud Game Servers. - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud game - - $ gcloud alpha game - diff --git a/gcloud/beta/game/locations/describe b/gcloud/beta/game/locations/describe deleted file mode 100644 index 1a7134067..000000000 --- a/gcloud/beta/game/locations/describe +++ /dev/null @@ -1,53 +0,0 @@ -NAME - gcloud beta game locations describe - describe a Location - -SYNOPSIS - gcloud beta game locations describe [LOCATION] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Describe a Cloud Game Services Location. - -EXAMPLES - To describe location 'my-location', run: - - $ gcloud beta game locations describe my-location - -POSITIONAL ARGUMENTS - Location resource - Cloud Game Services Location to describe. This - represents a Cloud resource. (NOTE) Some attributes are not given - arguments in this group but can be set in other ways. - - To set the project attribute: - ◆ provide the argument location on the command line with a fully - specified name; - ◆ set the property game_services/location with a fully specified name; - ◆ set the property core/project; - ◆ provide the argument --project on the command line. - - [LOCATION] - ID of the location or fully qualified identifier for the location. - - To set the location attribute: - ▸ provide the argument location on the command line; - ▸ set the property game_services/location. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the gameservices/v1beta API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud game locations describe - - $ gcloud alpha game locations describe - diff --git a/gcloud/beta/game/locations/help b/gcloud/beta/game/locations/help deleted file mode 100644 index 1163e9af7..000000000 --- a/gcloud/beta/game/locations/help +++ /dev/null @@ -1,31 +0,0 @@ -NAME - gcloud beta game locations - query Cloud Game Services Locations - -SYNOPSIS - gcloud beta game locations COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Query Cloud Game Services Locations. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -COMMANDS - COMMAND is one of the following: - - describe - (BETA) Describe a Location. - - list - (BETA) List Locations. - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud game locations - - $ gcloud alpha game locations - diff --git a/gcloud/beta/game/locations/list b/gcloud/beta/game/locations/list deleted file mode 100644 index b872108d7..000000000 --- a/gcloud/beta/game/locations/list +++ /dev/null @@ -1,68 +0,0 @@ -NAME - gcloud beta game locations list - list Locations - -SYNOPSIS - gcloud beta game locations list [--filter=EXPRESSION] [--limit=LIMIT] - [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) List Cloud Game Services Locations. - -EXAMPLES - To see the list of all Locations, run: - - $ gcloud beta game locations list - -LIST COMMAND FLAGS - --filter=EXPRESSION - Apply a Boolean filter EXPRESSION to each resource item to be listed. - If the expression evaluates True, then that item is listed. For more - details and examples of filter expressions, run $ gcloud topic filters. - This flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --limit=LIMIT - Maximum number of resources to list. The default is unlimited. This - flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --page-size=PAGE_SIZE - Some services group resource list output into pages. This flag - specifies the maximum number of resources per page. The default is - determined by the service if it supports paging, otherwise it is - unlimited (no paging). Paging may be applied before or after --filter - and --limit depending on the service. - - --sort-by=[FIELD,...] - Comma-separated list of resource field key names to sort by. The - default order is ascending. Prefix a field with ``~'' for descending - order on that field. This flag interacts with other flags that are - applied in this order: --flatten, --sort-by, --filter, --limit. - - --uri - Print a list of resource URIs instead of the default output, and change - the command output to a list of URIs. If this flag is used with - --format, the formatting is applied on this URI list. To display URIs - alongside other keys instead, use the uri() transform. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the gameservices/v1beta API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud game locations list - - $ gcloud alpha game locations list - diff --git a/gcloud/beta/game/operations/describe b/gcloud/beta/game/operations/describe deleted file mode 100644 index c81a2391a..000000000 --- a/gcloud/beta/game/operations/describe +++ /dev/null @@ -1,69 +0,0 @@ -NAME - gcloud beta game operations describe - describe an Operation - -SYNOPSIS - gcloud beta game operations describe (OPERATION : --location=LOCATION) - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Describe a Cloud Game Services Operation. - -EXAMPLES - To describe operation 'my-operation' in project 'my-project' and location - 'my-location', run: - - $ gcloud beta game operations describe my-operation \ - --project=my-project --location=my-location - -POSITIONAL ARGUMENTS - Operation resource - Cloud Game Services Operation to describe. The - arguments in this group can be used to specify the attributes of this - resource. (NOTE) Some attributes are not given arguments in this group but - can be set in other ways. - - To set the project attribute: - ◆ provide the argument operation on the command line with a fully - specified name; - ◆ set the property core/project; - ◆ provide the argument --project on the command line. - - This must be specified. - - OPERATION - ID of the 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 - Google Cloud location. - - 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; - ▸ set the property game_services/location. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the gameservices/v1beta API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud game operations describe - - $ gcloud alpha game operations describe - diff --git a/gcloud/beta/game/operations/help b/gcloud/beta/game/operations/help deleted file mode 100644 index 340b48f67..000000000 --- a/gcloud/beta/game/operations/help +++ /dev/null @@ -1,32 +0,0 @@ -NAME - gcloud beta game operations - deploy and manage Cloud Game Services - Operations - -SYNOPSIS - gcloud beta game operations COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Deploy and manage Cloud Game Services Operations. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -COMMANDS - COMMAND is one of the following: - - describe - (BETA) Describe an Operation. - - list - (BETA) List Operations. - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud game operations - - $ gcloud alpha game operations - diff --git a/gcloud/beta/game/operations/list b/gcloud/beta/game/operations/list deleted file mode 100644 index b4098acaa..000000000 --- a/gcloud/beta/game/operations/list +++ /dev/null @@ -1,89 +0,0 @@ -NAME - gcloud beta game operations list - list Operations - -SYNOPSIS - gcloud beta game operations list [--location=LOCATION] - [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] - [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) List Cloud Game Services Operations. - -EXAMPLES - To see the list of all Operations in project 'my-project' and location - 'my-location', run: - - $ gcloud beta game operations list --project=my-project \ - --location=my-location - -FLAGS - Location resource - Cloud Game Services Location of the Operations to - list. 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 game_services/location 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; - ▸ set the property game_services/location. - -LIST COMMAND FLAGS - --filter=EXPRESSION - Apply a Boolean filter EXPRESSION to each resource item to be listed. - If the expression evaluates True, then that item is listed. For more - details and examples of filter expressions, run $ gcloud topic filters. - This flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --limit=LIMIT - Maximum number of resources to list. The default is unlimited. This - flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --page-size=PAGE_SIZE - Some services group resource list output into pages. This flag - specifies the maximum number of resources per page. The default is - determined by the service if it supports paging, otherwise it is - unlimited (no paging). Paging may be applied before or after --filter - and --limit depending on the service. - - --sort-by=[FIELD,...] - Comma-separated list of resource field key names to sort by. The - default order is ascending. Prefix a field with ``~'' for descending - order on that field. This flag interacts with other flags that are - applied in this order: --flatten, --sort-by, --filter, --limit. - - --uri - Print a list of resource URIs instead of the default output, and change - the command output to a list of URIs. If this flag is used with - --format, the formatting is applied on this URI list. To display URIs - alongside other keys instead, use the uri() transform. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the gameservices/v1beta API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud game operations list - - $ gcloud alpha game operations list - diff --git a/gcloud/beta/game/servers/clusters/create b/gcloud/beta/game/servers/clusters/create deleted file mode 100644 index f478731a5..000000000 --- a/gcloud/beta/game/servers/clusters/create +++ /dev/null @@ -1,126 +0,0 @@ -NAME - gcloud beta game servers clusters create - create a Game Server Cluster - -SYNOPSIS - gcloud beta game servers clusters create - (CLUSTER : --location=LOCATION --realm=REALM) --dry-run - --gke-cluster=GKE_CLUSTER --namespace=NAMESPACE - [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] - [--preview-time=PREVIEW_TIME] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Create a Cloud Game Server Cluster. - -EXAMPLES - To create Game Server Cluster 'my-cluster' in project 'my-project', realm - 'my-realm', and location in 'my-location' run: - - $ gcloud beta game servers clusters create my-cluster \ - --project=my-project --realm=my-realm --location=my-location \ - --gke-cluster=projects/my-project/locations/my-location/\ - clusters/my-gke-cluster --namespace=default --labels=a=x,b=y \ - --no-dry-run - - To preview Game Server Cluster creation for 'my-cluster' in project - 'my-project', realm 'my-realm', and location in 'my-location' run: - - $ gcloud beta game servers clusters create my-cluster \ - --project=my-project --realm=my-realm --location=my-location \ - --gke-cluster=projects/my-project/locations/my-location/\ - clusters/my-gke-cluster --namespace=default --labels=a=x,b=y \ - --dry-run - -POSITIONAL ARGUMENTS - Game server cluster resource - Cloud Game Server Cluster 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 cluster 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. - - CLUSTER - ID of the game server cluster or fully qualified identifier for the - game server cluster. - - To set the cluster attribute: - ▸ provide the argument cluster on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --location=LOCATION - Google Cloud location. - - To set the location attribute: - ▸ provide the argument cluster on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - - --realm=REALM - Cloud Game Servers Realm. - - To set the realm attribute: - ▸ provide the argument cluster on the command line with a fully - specified name; - ▸ provide the argument --realm on the command line. - -REQUIRED FLAGS - --dry-run - Validate the creation, but do not execute it. - - --gke-cluster=GKE_CLUSTER - Full or partial name of a cluster in Google Kubernetes Engine (GKE) - where the game server cluster is installed, using the format: - 'projects/{project_id}/locations/{location_id}/clusters/{cluster_id}'. - Note, the location of the GKE cluster can be either a region or a zone. - Example: 'projects/my-project/locations/us-central1/clusters/test'. If - project and location are not specified, the project and location of the - Game Server Cluster resource are used to generate the full name of the - GKE cluster. - - --namespace=NAMESPACE - Namespace for Kubernetes API server endpoint. - -OPTIONAL FLAGS - --description=DESCRIPTION - Game server cluster description. - - --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. - - --preview-time=PREVIEW_TIME - This attribute is only relevant for preview (--dry-run). It is used to - validate the state for a future time. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 gameservices/v1beta API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud game servers clusters create - - $ gcloud alpha game servers clusters create - diff --git a/gcloud/beta/game/servers/clusters/delete b/gcloud/beta/game/servers/clusters/delete deleted file mode 100644 index 82cffb5b5..000000000 --- a/gcloud/beta/game/servers/clusters/delete +++ /dev/null @@ -1,95 +0,0 @@ -NAME - gcloud beta game servers clusters delete - delete a Game Server Cluster - -SYNOPSIS - gcloud beta game servers clusters delete - (CLUSTER : --location=LOCATION --realm=REALM) --dry-run - [--preview-time=PREVIEW_TIME] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Delete a Game Server Cluster. - -EXAMPLES - To delete Game Server Cluster 'my-cluster' in project 'my-project', realm - 'my-realm', and location 'my-location' run: - - $ gcloud beta game servers clusters delete my-cluster \ - --project=my-project --realm=my-realm --location=my-location \ - --no-dry-run - - To preview deletion of Game Server Cluster 'my-cluster' in project - 'my-project', realm 'my-realm', and location 'my-location' run: - - $ gcloud beta game servers clusters delete my-cluster \ - --project=my-project --realm=my-realm --location=my-location \ - --dry-run - -POSITIONAL ARGUMENTS - Game Server Cluster resource - Cloud Game Server Cluster 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 cluster on the command line with a fully - specified name; - ◆ provide the argument --project on the command line; - ◆ set the property core/project. - - This must be specified. - - CLUSTER - ID of the Game Server Cluster or fully qualified identifier for the - Game Server Cluster. - - To set the name attribute: - ▸ provide the argument cluster on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --location=LOCATION - Google Cloud location. - - To set the location attribute: - ▸ provide the argument cluster on the command line with a fully - specified name; - ▸ provide the argument --location on the command line. - - --realm=REALM - Cloud Game Server Realm. - - To set the realm attribute: - ▸ provide the argument cluster on the command line with a fully - specified name; - ▸ provide the argument --realm on the command line. - -REQUIRED FLAGS - --dry-run - Validate the operation, but do not execute it. - -OPTIONAL FLAGS - --preview-time=PREVIEW_TIME - This attribute is only relevant for preview (--dry-run). It is used to - validate the state for a future time. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 gameservices API. The full documentation for this API - can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud game servers clusters delete - - $ gcloud alpha game servers clusters delete - diff --git a/gcloud/beta/game/servers/clusters/describe b/gcloud/beta/game/servers/clusters/describe deleted file mode 100644 index d0d06fe32..000000000 --- a/gcloud/beta/game/servers/clusters/describe +++ /dev/null @@ -1,92 +0,0 @@ -NAME - gcloud beta game servers clusters describe - describe a Game Server Cluster - -SYNOPSIS - gcloud beta game servers clusters describe - (CLUSTER : --location=LOCATION --realm=REALM) - [--view=VIEW; default="basic"] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Describe a Cloud Game Server Cluster. - -EXAMPLES - To describe Game Server Cluster 'my-cluster' in project 'my-project', realm - 'my-realm', and location 'my-location', run: - - $ gcloud beta game servers clusters describe my-cluster \ - --project=my-project --realm=my-realm --location=my-location - -POSITIONAL ARGUMENTS - Game server cluster resource - Cloud Game Server Cluster 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 cluster 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. - - CLUSTER - ID of the game server cluster or fully qualified identifier for the - game server cluster. - - To set the cluster attribute: - ▸ provide the argument cluster on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --location=LOCATION - Google Cloud location. - - To set the location attribute: - ▸ provide the argument cluster on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - - --realm=REALM - Cloud Game Servers Realm. - - To set the realm attribute: - ▸ provide the argument cluster on the command line with a fully - specified name; - ▸ provide the argument --realm on the command line. - -FLAGS - --view=VIEW; default="basic" - There are two possible views, 'basic' and 'full'. The default view is - 'basic'. VIEW must be one of: - - basic - Include info of the game server cluster resource, but not the - registered Kubernetes cluster's info such as versions or provider. - - full - Include info for both the game server cluster resource and - registered Kuberentes cluster. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 gameservices/v1beta API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud game servers clusters describe - - $ gcloud alpha game servers clusters describe - diff --git a/gcloud/beta/game/servers/clusters/help b/gcloud/beta/game/servers/clusters/help deleted file mode 100644 index 48173cc97..000000000 --- a/gcloud/beta/game/servers/clusters/help +++ /dev/null @@ -1,41 +0,0 @@ -NAME - gcloud beta game servers clusters - deploy and manage Cloud Game Server - Clusters - -SYNOPSIS - gcloud beta game servers clusters COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Deploy and manage Cloud Game Server Clusters. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -COMMANDS - COMMAND is one of the following: - - create - (BETA) Create a Game Server Cluster. - - delete - (BETA) Delete a Game Server Cluster. - - describe - (BETA) Describe a Game Server Cluster. - - list - (BETA) List Game Server Clusters. - - update - (BETA) Update a Game Server Cluster. - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud game servers clusters - - $ gcloud alpha game servers clusters - diff --git a/gcloud/beta/game/servers/clusters/list b/gcloud/beta/game/servers/clusters/list deleted file mode 100644 index 4b5f186da..000000000 --- a/gcloud/beta/game/servers/clusters/list +++ /dev/null @@ -1,115 +0,0 @@ -NAME - gcloud beta game servers clusters list - list Game Server Clusters - -SYNOPSIS - gcloud beta game servers clusters list [--view=VIEW; default="basic"] - [--location=LOCATION --realm=REALM] [--filter=EXPRESSION] - [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) List Cloud Game Server Clusters. - -EXAMPLES - To see the list of all Game Server Clusters in project 'my-project', realm - 'my-realm', and location 'my-location', run: - - $ gcloud beta game servers clusters list --project=my-project \ - --realm=my-realm --location=my-location - -FLAGS - --view=VIEW; default="basic" - There are two possible views, 'basic' and 'full'. The default view is - 'basic'. VIEW must be one of: - - basic - Include info of the game server cluster resource, but not the - registered Kubernetes cluster's info such as versions or provider. - - full - Include info for both the game server cluster resource and - registered Kuberentes cluster. - - Realm resource - Cloud Game Servers Realm of the Game Server Cluster to - list. 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 --realm on the command line with a fully - specified name; - ◆ set the property game_services/default_realm with a fully specified - name; - ◆ set the property core/project; - ◆ provide the argument --project on the command line. - - --location=LOCATION - Google Cloud location. - - To set the location attribute: - ▸ provide the argument --realm on the command line with a fully - specified name; - ▸ set the property game_services/default_realm with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - - --realm=REALM - ID of the realm or fully qualified identifier for the realm. - - To set the realm attribute: - ▸ provide the argument --realm on the command line; - ▸ set the property game_services/default_realm. - -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 gameservices/v1beta API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud game servers clusters list - - $ gcloud alpha game servers clusters list - diff --git a/gcloud/beta/game/servers/clusters/update b/gcloud/beta/game/servers/clusters/update deleted file mode 100644 index d91b89381..000000000 --- a/gcloud/beta/game/servers/clusters/update +++ /dev/null @@ -1,130 +0,0 @@ -NAME - gcloud beta game servers clusters update - update a Game Server Cluster - -SYNOPSIS - gcloud beta game servers clusters update - (CLUSTER : --location=LOCATION --realm=REALM) --dry-run - [--description=DESCRIPTION] [--preview-time=PREVIEW_TIME] - [--update-labels=[KEY=VALUE,...]] - [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Update a Cloud Game Server Cluster. - -EXAMPLES - To update labels for Game Server Cluster 'my-cluster' in project - 'my-project', realm 'my-realm', and location in 'my-location' run: - - $ gcloud beta game servers clusters update my-cluster \ - --project=my-project --realm=my-realm --location=my-location \ - --update-labels="key1=val1" --no-dry-run - - To preview Game Server Cluster label update for 'my-cluster' in project - 'my-project', realm 'my-realm', and location in 'my-location' run: - - $ gcloud beta game servers clusters update my-cluster \ - --project=my-project --realm=my-realm --location=my-location \ - --update-labels="key1=val1" --dry-run - -POSITIONAL ARGUMENTS - Game server cluster resource - Cloud Game Server Cluster to update. The - arguments in this group can be used to specify the attributes of this - resource. (NOTE) Some attributes are not given arguments in this group but - can be set in other ways. - - To set the project attribute: - ◆ provide the argument cluster on the command line with a fully - specified name; - ◆ set the property core/project; - ◆ provide the argument --project on the command line. - - This must be specified. - - CLUSTER - ID of the game server cluster or fully qualified identifier for the - game server cluster. - - To set the cluster attribute: - ▸ provide the argument cluster on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --location=LOCATION - Google Cloud location. - - To set the location attribute: - ▸ provide the argument cluster on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - - --realm=REALM - Cloud Game Servers Realm. - - To set the realm attribute: - ▸ provide the argument cluster on the command line with a fully - specified name; - ▸ provide the argument --realm on the command line. - -REQUIRED FLAGS - --dry-run - Validate the changes, but do not execute it. - -OPTIONAL FLAGS - --description=DESCRIPTION - Description for the game server cluster. - - --preview-time=PREVIEW_TIME - This attribute is only relevant for preview (--dry-run). It is used to - validate the state for a future time. - - --update-labels=[KEY=VALUE,...] - List of label KEY=VALUE pairs to update. If a label exists, its value - is modified. Otherwise, a new label is created. - - Keys must start with a lowercase character and contain only hyphens - (-), underscores (_), lowercase characters, and numbers. Values must - contain only hyphens (-), underscores (_), lowercase characters, and - numbers. - - At most one of these can be specified: - - --clear-labels - Remove all labels. If --update-labels is also specified then - --clear-labels is applied first. - - For example, to remove all labels: - - $ gcloud beta game servers clusters update --clear-labels - - To remove all existing labels and create two new labels, foo and baz: - - $ gcloud beta game servers clusters update --clear-labels \ - --update-labels foo=bar,baz=qux - - --remove-labels=[KEY,...] - List of label keys to remove. If a label does not exist it is - silently ignored. If --update-labels is also specified then - --update-labels is applied first. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the gameservices/v1beta API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud game servers clusters update - - $ gcloud alpha game servers clusters update - diff --git a/gcloud/beta/game/servers/configs/create b/gcloud/beta/game/servers/configs/create deleted file mode 100644 index d3c630357..000000000 --- a/gcloud/beta/game/servers/configs/create +++ /dev/null @@ -1,140 +0,0 @@ -NAME - gcloud beta game servers configs create - create a Game Server Config - -SYNOPSIS - gcloud beta game servers configs create - (CONFIG : --deployment=DEPLOYMENT --location=LOCATION) - --fleet-configs-file=FLEET_CONFIGS_FILE [--async] - [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] - [--scaling-configs-file=SCALING_CONFIGS_FILE] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Create a Cloud Game Server Config for a Game Server Deployment. - -EXAMPLES - To create Game Server Config 'my-config' in project 'my-project', - deployment 'my-deployment', and location in 'global'(configs only support - the 'global' location) run: - - $ gcloud beta game servers configs create my-config \ - --project=my-project --deployment=my-deployment \ - --location=global --deployment=my-deployment \ - --description=description --labels=a=x,b=y \ - --fleet-configs-file=fleet_configs.json - -POSITIONAL ARGUMENTS - Game server config resource - Cloud Game Server Config 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 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. - - CONFIG - ID of the game server config or fully qualified identifier for the - game server config. - - To set the config attribute: - ▸ provide the argument config on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --deployment=DEPLOYMENT - Cloud Game Servers Deployment. - - To set the deployment attribute: - ▸ provide the argument config on the command line with a fully - specified name; - ▸ provide the argument --deployment on the command line. - - --location=LOCATION - Google Cloud location. - - To set the location attribute: - ▸ provide the argument config on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -REQUIRED FLAGS - --fleet-configs-file=FLEET_CONFIGS_FILE - Path to a JSON or YAML file that contains fleet configs. The fleet spec - field in configs file follows Agones Fleet custom resource. Please see - https://github.com/googleforgames/agones/blob/master/examples/simple-udp/fleet.yaml - for example and https://agones.dev/site/docs/reference/fleet/ for Fleet - Spec definition. - -OPTIONAL FLAGS - --async - Return immediately, without waiting for the operation in progress to - complete. - - --description=DESCRIPTION - Game server config description. - - --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. - - --scaling-configs-file=SCALING_CONFIGS_FILE - Path to a JSON or YAML file that contains scaling configs. The fleet - autoscaler spec field in configs file follows Agones Fleet Autoscaler - custom resource. Please see - https://github.com/googleforgames/agones/blob/master/examples/simple-udp/fleetautoscaler.yaml - for example and https://agones.dev/site/docs/reference/fleetautoscaler/ - for Fleet Autoscaler Spec definition. Scaling config file can also - specifies schedules. Contents of a sample yaml file: - - - fleetAutoscalerSpec: - policy: - type: Buffer - buffer: - bufferSize: 10 - minReplicas: 10 - maxReplicas: 20 - name: scaling-config-2 - schedules: - - startTime: '2020-01-01T01:00:00Z' - endTime: '2020-01-02T01:00:00Z' - cronSpec: '0 9 * * *' - cronJobDuration: 3600s - - fleetAutoscalerSpec: - policy: - type: Buffer - buffer: - bufferSize: 2 - minReplicas: 2 - maxReplicas: 4 - name: scaling-config-1 - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 gameservices/v1beta API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud game servers configs create - - $ gcloud alpha game servers configs create - diff --git a/gcloud/beta/game/servers/configs/delete b/gcloud/beta/game/servers/configs/delete deleted file mode 100644 index 203b2bb84..000000000 --- a/gcloud/beta/game/servers/configs/delete +++ /dev/null @@ -1,85 +0,0 @@ -NAME - gcloud beta game servers configs delete - delete a Game Server Config - -SYNOPSIS - gcloud beta game servers configs delete - (CONFIG : --deployment=DEPLOYMENT --location=LOCATION) [--async] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Delete a Cloud Game Server Config. - -EXAMPLES - To delete Game Server Config 'my-config' in project 'my-project', - deployment 'my-deployment', and location 'global'(configs only support the - 'global' location), run: - - $ gcloud beta game servers configs delete my-config \ - --project=my-project --deployment=deployment --location=global - -POSITIONAL ARGUMENTS - Game server config resource - Cloud Game Server Config 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 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. - - CONFIG - ID of the game server config or fully qualified identifier for the - game server config. - - To set the config attribute: - ▸ provide the argument config on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --deployment=DEPLOYMENT - Cloud Game Servers Deployment. - - To set the deployment attribute: - ▸ provide the argument config on the command line with a fully - specified name; - ▸ provide the argument --deployment on the command line. - - --location=LOCATION - Google Cloud location. - - To set the location attribute: - ▸ provide the argument config on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -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 gameservices/v1beta API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud game servers configs delete - - $ gcloud alpha game servers configs delete - diff --git a/gcloud/beta/game/servers/configs/describe b/gcloud/beta/game/servers/configs/describe deleted file mode 100644 index c7f6ca94a..000000000 --- a/gcloud/beta/game/servers/configs/describe +++ /dev/null @@ -1,81 +0,0 @@ -NAME - gcloud beta game servers configs describe - describe a Game Server Config - -SYNOPSIS - gcloud beta game servers configs describe - (CONFIG : --deployment=DEPLOYMENT --location=LOCATION) - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Describe a Cloud Game Server Config. - -EXAMPLES - To describe Game Server Config 'my-config' in project 'my-project', - deployment 'my-deployment' and location 'global'(configs only support the - 'global' location), run: - - $ gcloud beta game servers configs describe my-config \ - --project=my-project --deployment=my-deployment \ - --location=global - -POSITIONAL ARGUMENTS - Game server config resource - Cloud Game Server Config 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 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. - - CONFIG - ID of the game server config or fully qualified identifier for the - game server config. - - To set the config attribute: - ▸ provide the argument config on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --deployment=DEPLOYMENT - Cloud Game Servers Deployment. - - To set the deployment attribute: - ▸ provide the argument config on the command line with a fully - specified name; - ▸ provide the argument --deployment on the command line. - - --location=LOCATION - Google Cloud location. - - To set the location attribute: - ▸ provide the argument config on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the gameservices/v1beta API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud game servers configs describe - - $ gcloud alpha game servers configs describe - diff --git a/gcloud/beta/game/servers/configs/help b/gcloud/beta/game/servers/configs/help deleted file mode 100644 index 1cf7ff435..000000000 --- a/gcloud/beta/game/servers/configs/help +++ /dev/null @@ -1,38 +0,0 @@ -NAME - gcloud beta game servers configs - deploy and manage Cloud Game Server - Configs - -SYNOPSIS - gcloud beta game servers configs COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Deploy and manage Cloud Game Server Configs. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -COMMANDS - COMMAND is one of the following: - - create - (BETA) Create a Game Server Config. - - delete - (BETA) Delete a Game Server Config. - - describe - (BETA) Describe a Game Server Config. - - list - (BETA) List Configs. - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud game servers configs - - $ gcloud alpha game servers configs - diff --git a/gcloud/beta/game/servers/configs/list b/gcloud/beta/game/servers/configs/list deleted file mode 100644 index b215f9af3..000000000 --- a/gcloud/beta/game/servers/configs/list +++ /dev/null @@ -1,105 +0,0 @@ -NAME - gcloud beta game servers configs list - list Configs - -SYNOPSIS - gcloud beta game servers configs list - [--deployment=DEPLOYMENT --location=LOCATION] [--filter=EXPRESSION] - [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) List Cloud Game Server Configs. - -EXAMPLES - To see the list of all Game Server Configs in project 'my-project', - deployment 'my-deployment' and location 'global'(configs only support the - 'global' location), run: - - $ gcloud beta game servers configs list --project=my-project \ - --deployment=my-deployment --location=global - -FLAGS - Deployment resource - Cloud Game Server Deployment of the Game Server - Configs to list. 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 --deployment on the command line with a fully - specified name; - ◆ set the property game_services/default_deployment with a fully - specified name; - ◆ set the property core/project; - ◆ provide the argument --project on the command line. - - --deployment=DEPLOYMENT - ID of the deployment or fully qualified identifier for the - deployment. - - To set the deployment attribute: - ▸ provide the argument --deployment on the command line; - ▸ set the property game_services/default_deployment. - - --location=LOCATION - Google Cloud location. - - To set the location attribute: - ▸ provide the argument --deployment on the command line with a - fully specified name; - ▸ set the property game_services/default_deployment with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -LIST COMMAND FLAGS - --filter=EXPRESSION - Apply a Boolean filter EXPRESSION to each resource item to be listed. - If the expression evaluates True, then that item is listed. For more - details and examples of filter expressions, run $ gcloud topic filters. - This flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --limit=LIMIT - Maximum number of resources to list. The default is unlimited. This - flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --page-size=PAGE_SIZE - Some services group resource list output into pages. This flag - specifies the maximum number of resources per page. The default is - determined by the service if it supports paging, otherwise it is - unlimited (no paging). Paging may be applied before or after --filter - and --limit depending on the service. - - --sort-by=[FIELD,...] - Comma-separated list of resource field key names to sort by. The - default order is ascending. Prefix a field with ``~'' for descending - order on that field. This flag interacts with other flags that are - applied in this order: --flatten, --sort-by, --filter, --limit. - - --uri - Print a list of resource URIs instead of the default output, and change - the command output to a list of URIs. If this flag is used with - --format, the formatting is applied on this URI list. To display URIs - alongside other keys instead, use the uri() transform. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the gameservices/v1beta API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud game servers configs list - - $ gcloud alpha game servers configs list - diff --git a/gcloud/beta/game/servers/deployments/create b/gcloud/beta/game/servers/deployments/create deleted file mode 100644 index ca81415e0..000000000 --- a/gcloud/beta/game/servers/deployments/create +++ /dev/null @@ -1,90 +0,0 @@ -NAME - gcloud beta game servers deployments create - create a Deployment - -SYNOPSIS - gcloud beta game servers deployments create - (DEPLOYMENT : --location=LOCATION) [--async] - [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Create a Cloud Game Server Deployment. - -EXAMPLES - To create Game Server Deployment 'my-deployment' in project 'my-project' - and location in 'global'(deployments only support the 'global' location) - run: - - $ gcloud beta game servers deployments create my-deployment \ - --project=my-project --location=global \ - --description=description --labels=a=x,b=y - -POSITIONAL ARGUMENTS - Deployment resource - Cloud Game Server Deployment 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 deployment 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. - - DEPLOYMENT - ID of the deployment or fully qualified identifier for the - deployment. - - To set the deployment attribute: - ▸ provide the argument deployment 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 location. - - To set the location attribute: - ▸ provide the argument deployment on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -FLAGS - --async - Return immediately, without waiting for the operation in progress to - complete. - - --description=DESCRIPTION - Game server deployment description. - - --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 gameservices/v1beta API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud game servers deployments create - - $ gcloud alpha game servers deployments create - diff --git a/gcloud/beta/game/servers/deployments/delete b/gcloud/beta/game/servers/deployments/delete deleted file mode 100644 index c44762328..000000000 --- a/gcloud/beta/game/servers/deployments/delete +++ /dev/null @@ -1,75 +0,0 @@ -NAME - gcloud beta game servers deployments delete - delete a Deployment - -SYNOPSIS - gcloud beta game servers deployments delete - (DEPLOYMENT : --location=LOCATION) [--async] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Delete a Cloud Game Server Deployment. - -EXAMPLES - To delete Game Server Deployment 'my-deployment' in project 'my-project' - and location 'global'(deployments only support the 'global' location), run: - - $ gcloud beta game servers deployments delete my-deployment \ - --project=my-project --location=global - -POSITIONAL ARGUMENTS - Deployment resource - Cloud Game Server Deployment 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 deployment 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. - - DEPLOYMENT - ID of the deployment or fully qualified identifier for the - deployment. - - To set the deployment attribute: - ▸ provide the argument deployment 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 location. - - To set the location attribute: - ▸ provide the argument deployment on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -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 gameservices/v1beta API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud game servers deployments delete - - $ gcloud alpha game servers deployments delete - diff --git a/gcloud/beta/game/servers/deployments/describe b/gcloud/beta/game/servers/deployments/describe deleted file mode 100644 index 7f6172a8a..000000000 --- a/gcloud/beta/game/servers/deployments/describe +++ /dev/null @@ -1,70 +0,0 @@ -NAME - gcloud beta game servers deployments describe - describe a Deployment - -SYNOPSIS - gcloud beta game servers deployments describe - (DEPLOYMENT : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Describe a Cloud Game Server Deployment. - -EXAMPLES - To describe Game Server Deployment 'my-deployment' in project 'my-project' - and location 'global'(deployments only support the 'global' location), run: - - $ gcloud beta game servers deployments describe my-deployment \ - --project=my-project --location=global - -POSITIONAL ARGUMENTS - Deployment resource - Cloud Game Server Deployment 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 deployment 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. - - DEPLOYMENT - ID of the deployment or fully qualified identifier for the - deployment. - - To set the deployment attribute: - ▸ provide the argument deployment 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 location. - - To set the location attribute: - ▸ provide the argument deployment on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the gameservices/v1beta API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud game servers deployments describe - - $ gcloud alpha game servers deployments describe - diff --git a/gcloud/beta/game/servers/deployments/describe-rollout b/gcloud/beta/game/servers/deployments/describe-rollout deleted file mode 100644 index b22499de6..000000000 --- a/gcloud/beta/game/servers/deployments/describe-rollout +++ /dev/null @@ -1,71 +0,0 @@ -NAME - gcloud beta game servers deployments describe-rollout - describe a Rollout - -SYNOPSIS - gcloud beta game servers deployments describe-rollout - (DEPLOYMENT : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Describe a Cloud Game Server Deployment Rollout. - -EXAMPLES - To describe the Rollout of Game Server Deployment 'my-deployment' in - project 'my-project', and location 'global'(deployments only support the - 'global' location), run: - - $ gcloud beta game servers deployments describe-rollout \ - my-deployment --project=my-project --location=global - -POSITIONAL ARGUMENTS - Deployment resource - Cloud Game Server Deployment Rollout 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 deployment 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. - - DEPLOYMENT - ID of the deployment or fully qualified identifier for the - deployment. - - To set the deployment attribute: - ▸ provide the argument deployment 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 location. - - To set the location attribute: - ▸ provide the argument deployment on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the gameservices/v1beta API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud game servers deployments describe-rollout - - $ gcloud alpha game servers deployments describe-rollout - diff --git a/gcloud/beta/game/servers/deployments/fetch-state b/gcloud/beta/game/servers/deployments/fetch-state deleted file mode 100644 index 2eccf95ec..000000000 --- a/gcloud/beta/game/servers/deployments/fetch-state +++ /dev/null @@ -1,72 +0,0 @@ -NAME - gcloud beta game servers deployments fetch-state - fetches the state of a - Deployment - -SYNOPSIS - gcloud beta game servers deployments fetch-state - (DEPLOYMENT : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Fetches a Cloud Game Server Deployment State from all clusters. - -EXAMPLES - To fetch the deployment state for Game Server Deployment 'my-deployment' in - project 'my-project' and location 'global'(deployments only support the - 'global' location), run: - - $ gcloud beta game servers deployments fetch-state my-deployment \ - --project=my-project --location=global - -POSITIONAL ARGUMENTS - Deployment resource - Cloud Game Server Deployment State to fetch. 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 deployment 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. - - DEPLOYMENT - ID of the deployment or fully qualified identifier for the - deployment. - - To set the deployment attribute: - ▸ provide the argument deployment 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 location. - - To set the location attribute: - ▸ provide the argument deployment on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the gameservices/v1beta API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud game servers deployments fetch-state - - $ gcloud alpha game servers deployments fetch-state - diff --git a/gcloud/beta/game/servers/deployments/help b/gcloud/beta/game/servers/deployments/help deleted file mode 100644 index 0e6b8da4a..000000000 --- a/gcloud/beta/game/servers/deployments/help +++ /dev/null @@ -1,50 +0,0 @@ -NAME - gcloud beta game servers deployments - deploy and manage Cloud Game Server - Deployments - -SYNOPSIS - gcloud beta game servers deployments COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Deploy and manage Cloud Game Server Deployments. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -COMMANDS - COMMAND is one of the following: - - create - (BETA) Create a Deployment. - - delete - (BETA) Delete a Deployment. - - describe - (BETA) Describe a Deployment. - - describe-rollout - (BETA) Describe a Rollout. - - fetch-state - (BETA) Fetches the state of a Deployment. - - list - (BETA) List Deployments. - - update - (BETA) Update a Deployment. - - update-rollout - (BETA) Update a Deployment Rollout. - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud game servers deployments - - $ gcloud alpha game servers deployments - diff --git a/gcloud/beta/game/servers/deployments/list b/gcloud/beta/game/servers/deployments/list deleted file mode 100644 index 5b0683b42..000000000 --- a/gcloud/beta/game/servers/deployments/list +++ /dev/null @@ -1,89 +0,0 @@ -NAME - gcloud beta game servers deployments list - list Deployments - -SYNOPSIS - gcloud beta game servers deployments list [--location=LOCATION] - [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] - [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) List Cloud Game Server Deployments. - -EXAMPLES - To see the list of all Game Server Deployments in project 'my-project' and - location 'global'(deployments only support the 'global' location), run: - - $ gcloud beta game servers deployments list --project=my-project \ - --location=global - -FLAGS - Location resource - Cloud Game Servers Location of the Deployments to - list. 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 game_services/location 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; - ▸ set the property game_services/location. - -LIST COMMAND FLAGS - --filter=EXPRESSION - Apply a Boolean filter EXPRESSION to each resource item to be listed. - If the expression evaluates True, then that item is listed. For more - details and examples of filter expressions, run $ gcloud topic filters. - This flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --limit=LIMIT - Maximum number of resources to list. The default is unlimited. This - flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --page-size=PAGE_SIZE - Some services group resource list output into pages. This flag - specifies the maximum number of resources per page. The default is - determined by the service if it supports paging, otherwise it is - unlimited (no paging). Paging may be applied before or after --filter - and --limit depending on the service. - - --sort-by=[FIELD,...] - Comma-separated list of resource field key names to sort by. The - default order is ascending. Prefix a field with ``~'' for descending - order on that field. This flag interacts with other flags that are - applied in this order: --flatten, --sort-by, --filter, --limit. - - --uri - Print a list of resource URIs instead of the default output, and change - the command output to a list of URIs. If this flag is used with - --format, the formatting is applied on this URI list. To display URIs - alongside other keys instead, use the uri() transform. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the gameservices/v1beta API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud game servers deployments list - - $ gcloud alpha game servers deployments list - diff --git a/gcloud/beta/game/servers/deployments/update b/gcloud/beta/game/servers/deployments/update deleted file mode 100644 index b476e311c..000000000 --- a/gcloud/beta/game/servers/deployments/update +++ /dev/null @@ -1,118 +0,0 @@ -NAME - gcloud beta game servers deployments update - update a Deployment - -SYNOPSIS - gcloud beta game servers deployments update - (DEPLOYMENT : --location=LOCATION) [--async] - [--description=DESCRIPTION] [--update-labels=[KEY=VALUE,...]] - [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Update a Cloud Game Server Deployment. - -EXAMPLES - To update description for Game Server Deployment 'my-deployment' in project - 'my-project', and location in 'global'(deployments only support the default - 'global' location) run: - - $ gcloud beta game servers deployments update my-deployment \ - --project=my-project --location=global \ - --description="New description" - - To update labels for Game Server Deployment 'my-deployment' in project - 'my-project' run: - - $ gcloud beta game servers deployments update my-deployment \ - --project=my-project --location=global \ - --update-labels="key1=val1" - -POSITIONAL ARGUMENTS - Deployment resource - Cloud Game Server Deployment to update. The - arguments in this group can be used to specify the attributes of this - resource. (NOTE) Some attributes are not given arguments in this group but - can be set in other ways. - - To set the project attribute: - ◆ provide the argument deployment 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. - - DEPLOYMENT - ID of the deployment or fully qualified identifier for the - deployment. - - To set the deployment attribute: - ▸ provide the argument deployment 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 location. - - To set the location attribute: - ▸ provide the argument deployment on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -FLAGS - --async - Return immediately, without waiting for the operation in progress to - complete. - - --description=DESCRIPTION - Description for the game server deployment. - - --update-labels=[KEY=VALUE,...] - List of label KEY=VALUE pairs to update. If a label exists, its value - is modified. Otherwise, a new label is created. - - Keys must start with a lowercase character and contain only hyphens - (-), underscores (_), lowercase characters, and numbers. Values must - contain only hyphens (-), underscores (_), lowercase characters, and - numbers. - - At most one of these can be specified: - - --clear-labels - Remove all labels. If --update-labels is also specified then - --clear-labels is applied first. - - For example, to remove all labels: - - $ gcloud beta game servers deployments update --clear-labels - - To remove all existing labels and create two new labels, foo and baz: - - $ gcloud beta game servers deployments update --clear-labels \ - --update-labels foo=bar,baz=qux - - --remove-labels=[KEY,...] - List of label keys to remove. If a label does not exist it is - silently ignored. If --update-labels is also specified then - --update-labels is applied first. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the gameservices/v1beta API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud game servers deployments update - - $ gcloud alpha game servers deployments update - diff --git a/gcloud/beta/game/servers/deployments/update-rollout b/gcloud/beta/game/servers/deployments/update-rollout deleted file mode 100644 index 1927c564e..000000000 --- a/gcloud/beta/game/servers/deployments/update-rollout +++ /dev/null @@ -1,139 +0,0 @@ -NAME - gcloud beta game servers deployments update-rollout - update a Deployment - Rollout - -SYNOPSIS - gcloud beta game servers deployments update-rollout - (DEPLOYMENT : --location=LOCATION) --dry-run - [--preview-time=PREVIEW_TIME] - [--clear-config-overrides - | --config-overrides-file=CONFIG_OVERRIDES_FILE] - [--clear-default-config | --default-config=DEFAULT_CONFIG] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Update a Cloud Game Server Deployment Rollout. - -EXAMPLES - To update a rollout target with new default game server config: - - $ gcloud beta game servers deployments update-rollout \ - example-deployment --default-config=version1 --no-dry-run - - To set a rollout target gradually by setting overrides in a YAML file using - the --config-overrides-file flag: - - $ gcloud beta game servers deployments update-rollout \ - example-deployment \ - --config-overrides-file=gs-cfg-overrides.yaml --no-dry-run - - Contents of gs-cfg-overrides.yaml: - - - realmsSelector: - realms: - - projects/test-project-1/locations/us-west1/realms/realm-1 - - projects/test-project-1/locations/us-west1/realms/realm-2 - configVersion: version2 - - realmsSelector: - realms: - - projects/test-project-1/locations/us-west1/realms/realm-3 - configVersion: version3 - -POSITIONAL ARGUMENTS - Deployment resource - Cloud Game Server Deployment Resource to update. The - arguments in this group can be used to specify the attributes of this - 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 deployment 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. - - DEPLOYMENT - ID of the deployment or fully qualified identifier for the - deployment. - - To set the deployment attribute: - ▸ provide the argument deployment 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 location. - - To set the location attribute: - ▸ provide the argument deployment on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -REQUIRED FLAGS - --dry-run - Validate the rollout changes, but do not execute it. - -OPTIONAL FLAGS - --preview-time=PREVIEW_TIME - This attribute is only relevant for preview (--dry-run). It is used to - validate the state for a future time. - - At most one of these can be specified: - - --clear-config-overrides - Clear the config overrides. - - --config-overrides-file=CONFIG_OVERRIDES_FILE - JSON/YAML file that specifies the Game Server config overrides. This - file can be used to gradually rollout a new config version. The - following sample file indicates that the version2 config is rolled - out to realm-1 and realm-2 while the version3 config is deployed to - realm-3. The rest of the realms are deployed with the default config - version (if one is specified). Contents of a sample yaml file: - - - realmsSelector: - realms: - - projects/test-project-1/locations/us-west1/realms/realm-1 - - projects/test-project-1/locations/us-west1/realms/realm-2 - configVersion: version2 - - realmsSelector: - realms: - - projects/test-project-1/locations/us-west1/realms/realm-3 - configVersion: version3 - - At most one of these can be specified: - - --clear-default-config - Clear the default config. - - --default-config=DEFAULT_CONFIG - Game Server config to be deployed to all clusters. The value of this - field must match an existing game server config that is a - sub-resource to the given game server deployment. If not specified, - there won't be a default config which means only the clusters - specified in the config overrides will have configs applied. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 gameservices/v1beta API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud game servers deployments update-rollout - - $ gcloud alpha game servers deployments update-rollout - diff --git a/gcloud/beta/game/servers/help b/gcloud/beta/game/servers/help deleted file mode 100644 index bc8d26785..000000000 --- a/gcloud/beta/game/servers/help +++ /dev/null @@ -1,37 +0,0 @@ -NAME - gcloud beta game servers - managed Cloud Game Servers - -SYNOPSIS - gcloud beta game servers GROUP [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Managed Cloud Game Servers. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -GROUPS - GROUP is one of the following: - - clusters - (BETA) Deploy and manage Cloud Game Server Clusters. - - configs - (BETA) Deploy and manage Cloud Game Server Configs. - - deployments - (BETA) Deploy and manage Cloud Game Server Deployments. - - realms - (BETA) Deploy and manage Cloud Game Server Realms. - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud game servers - - $ gcloud alpha game servers - diff --git a/gcloud/beta/game/servers/realms/create b/gcloud/beta/game/servers/realms/create deleted file mode 100644 index 055f05cd6..000000000 --- a/gcloud/beta/game/servers/realms/create +++ /dev/null @@ -1,93 +0,0 @@ -NAME - gcloud beta game servers realms create - create a Realm - -SYNOPSIS - gcloud beta game servers realms create (REALM : --location=LOCATION) - --time-zone=TIME_ZONE [--async] [--description=DESCRIPTION] - [--labels=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Create a Cloud Game Server Realm. - -EXAMPLES - To create Realm 'my-realm' in project 'my-project' with location in - 'my-location' and time zone 'UTC', run: - - $ gcloud beta game servers realms create my-realm \ - --project=my-project --location=my-location --time-zone=UTC \ - --labels=a=x,b=y - -POSITIONAL ARGUMENTS - Realm resource - Cloud Game Server Realm 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 realm 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. - - REALM - ID of the realm or fully qualified identifier for the realm. - - To set the realm attribute: - ▸ provide the argument realm 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 location. - - To set the location attribute: - ▸ provide the argument realm on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -REQUIRED FLAGS - --time-zone=TIME_ZONE - Time zone where all realm-specific policies are evaluated. The value of - this field must be from the IANA time zone database: - https://www.iana.org/time-zones. - -OPTIONAL FLAGS - --async - Return immediately, without waiting for the operation in progress to - complete. - - --description=DESCRIPTION - Game server realm description. - - --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 gameservices/v1beta API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud game servers realms create - - $ gcloud alpha game servers realms create - diff --git a/gcloud/beta/game/servers/realms/delete b/gcloud/beta/game/servers/realms/delete deleted file mode 100644 index 745cd3cc1..000000000 --- a/gcloud/beta/game/servers/realms/delete +++ /dev/null @@ -1,74 +0,0 @@ -NAME - gcloud beta game servers realms delete - delete a Realm - -SYNOPSIS - gcloud beta game servers realms delete (REALM : --location=LOCATION) - [--async] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Delete a Cloud Game Server Realm. - -EXAMPLES - To delete Realm 'my-realm' in project 'my-project' and location - 'my-location', run: - - $ gcloud beta game servers realms delete my-realm \ - --project=my-project --location=my-location - -POSITIONAL ARGUMENTS - Realm resource - Cloud Game Server Realm 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 realm 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. - - REALM - ID of the realm or fully qualified identifier for the realm. - - To set the realm attribute: - ▸ provide the argument realm 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 location. - - To set the location attribute: - ▸ provide the argument realm on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -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 gameservices/v1beta API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud game servers realms delete - - $ gcloud alpha game servers realms delete - diff --git a/gcloud/beta/game/servers/realms/describe b/gcloud/beta/game/servers/realms/describe deleted file mode 100644 index b52966a10..000000000 --- a/gcloud/beta/game/servers/realms/describe +++ /dev/null @@ -1,69 +0,0 @@ -NAME - gcloud beta game servers realms describe - describe a Realm - -SYNOPSIS - gcloud beta game servers realms describe (REALM : --location=LOCATION) - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Describe a Cloud Game Server Realm. - -EXAMPLES - To describe Realm 'my-realm' in project 'my-project' and location - 'my-location', run: - - $ gcloud beta game servers realms describe my-realm \ - --project=my-project --location=my-location - -POSITIONAL ARGUMENTS - Realm resource - Cloud Game Server Realm 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 realm 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. - - REALM - ID of the realm or fully qualified identifier for the realm. - - To set the realm attribute: - ▸ provide the argument realm 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 location. - - To set the location attribute: - ▸ provide the argument realm on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the gameservices/v1beta API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud game servers realms describe - - $ gcloud alpha game servers realms describe - diff --git a/gcloud/beta/game/servers/realms/help b/gcloud/beta/game/servers/realms/help deleted file mode 100644 index d677646c1..000000000 --- a/gcloud/beta/game/servers/realms/help +++ /dev/null @@ -1,41 +0,0 @@ -NAME - gcloud beta game servers realms - deploy and manage Cloud Game Server - Realms - -SYNOPSIS - gcloud beta game servers realms COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Deploy and manage Cloud Game Server Realms. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -COMMANDS - COMMAND is one of the following: - - create - (BETA) Create a Realm. - - delete - (BETA) Delete a Realm. - - describe - (BETA) Describe a Realm. - - list - (BETA) List Realms. - - update - (BETA) Update a Realm. - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud game servers realms - - $ gcloud alpha game servers realms - diff --git a/gcloud/beta/game/servers/realms/update b/gcloud/beta/game/servers/realms/update deleted file mode 100644 index af3ae8f5e..000000000 --- a/gcloud/beta/game/servers/realms/update +++ /dev/null @@ -1,132 +0,0 @@ -NAME - gcloud beta game servers realms update - update a Realm - -SYNOPSIS - gcloud beta game servers realms update (REALM : --location=LOCATION) - --dry-run [--description=DESCRIPTION] [--preview-time=PREVIEW_TIME] - [--time-zone=TIME_ZONE] [--update-labels=[KEY=VALUE,...]] - [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Update a Cloud Game Server Realm. - -EXAMPLES - To update Realm 'my-realm' in project 'my-project' and location in - 'my-location' with a new time-zone run: - - $ gcloud beta game servers realms update my-realm \ - --project=my-project --location=my-location --time-zone=EST \ - --no-dry-run - - To preview Realm update for 'my-realm' in project 'my-project' and location - in 'my-location' with a new time-zone run: - - $ gcloud beta game servers realms update my-realm \ - --project=my-project --location=my-location --time-zone=EST \ - --dry-run - - To update labels for Realm 'my-realm' in project 'my-project' and location - in 'my-location' run: - - $ gcloud beta game servers realms update my-realm \ - --project=my-project --location=my-location \ - --update-labels="key1=val1" --no-dry-run - -POSITIONAL ARGUMENTS - Realm resource - Cloud Game Server Realm to update. The arguments in this - group can be used to specify the attributes of this resource. (NOTE) Some - attributes are not given arguments in this group but can be set in other - ways. - - To set the project attribute: - ◆ provide the argument realm 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. - - REALM - ID of the realm or fully qualified identifier for the realm. - - To set the realm attribute: - ▸ provide the argument realm 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 location. - - To set the location attribute: - ▸ provide the argument realm on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -REQUIRED FLAGS - --dry-run - Validate the changes, but do not execute it. - -OPTIONAL FLAGS - --description=DESCRIPTION - Description for the realm. - - --preview-time=PREVIEW_TIME - This attribute is only relevant for preview (--dry-run). It is used to - validate the state for a future time. - - --time-zone=TIME_ZONE - Time zone where all realm-specific policies are evaluated. The value of - this field must be from the IANA time zone database: - https://www.iana.org/time-zones. - - --update-labels=[KEY=VALUE,...] - List of label KEY=VALUE pairs to update. If a label exists, its value - is modified. Otherwise, a new label is created. - - Keys must start with a lowercase character and contain only hyphens - (-), underscores (_), lowercase characters, and numbers. Values must - contain only hyphens (-), underscores (_), lowercase characters, and - numbers. - - At most one of these can be specified: - - --clear-labels - Remove all labels. If --update-labels is also specified then - --clear-labels is applied first. - - For example, to remove all labels: - - $ gcloud beta game servers realms update --clear-labels - - To remove all existing labels and create two new labels, foo and baz: - - $ gcloud beta game servers realms update --clear-labels \ - --update-labels foo=bar,baz=qux - - --remove-labels=[KEY,...] - List of label keys to remove. If a label does not exist it is - silently ignored. If --update-labels is also specified then - --update-labels is applied first. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the gameservices/v1beta API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud game servers realms update - - $ gcloud alpha game servers realms update - diff --git a/gcloud/beta/netapp/backup-vaults/backups/create b/gcloud/beta/netapp/backup-vaults/backups/create new file mode 100644 index 000000000..5176d03de --- /dev/null +++ b/gcloud/beta/netapp/backup-vaults/backups/create @@ -0,0 +1,169 @@ +NAME + gcloud beta netapp backup-vaults backups create - create a Cloud NetApp + Backup + +SYNOPSIS + gcloud beta netapp backup-vaults backups create + (BACKUP : --location=LOCATION) [--async] [--backup-vault=BACKUP_VAULT] + [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] + [--source-snapshot=SOURCE_SNAPSHOT] [--source-volume=SOURCE_VOLUME] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create a Cloud NetApp Backup. + +EXAMPLES + The following command creates a Backup named BACKUP attached to a Backup + Vault named BACKUP_VAULT, and a source volume named SOURCE_VOL + asynchronously using the specified arguments: + + $ gcloud beta netapp backup-vaults backups create BACKUP \ + --location=LOCATION --async --backup-vault=BACKUP_VAULT \ + --source-volume=SOURCE_VOL + +POSITIONAL ARGUMENTS + Backup resource - The Backup 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 backup 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 backup_vault attribute: + ◆ provide the argument backup on the command line with a fully + specified name; + ◆ provide the argument --backup-vault on the command line. + + This must be specified. + + BACKUP + ID of the backup or fully qualified identifier for the backup. + + To set the backup attribute: + ▸ provide the argument backup 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 of the backup. + + To set the location attribute: + ▸ provide the argument backup on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + Backup vault resource - The Backup Vault that the Backup is stored in 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 --backup-vault 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 --backup-vault on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location; + ◆ set the property netapp/region. + + --backup-vault=BACKUP_VAULT + ID of the backup_vault or fully qualified identifier for the + backup_vault. + + To set the backup_vault attribute: + ▸ provide the argument --backup-vault on the command line. + + --description=DESCRIPTION + A description of the Cloud NetApp Backup Vault + + --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. + + Snapshot resource - The full name of the Source Snapshot that the Backup + is based on', Format: + projects/{project_id}/locations/{location}/volumes/{volume_id}/snapshots/{snapshot_id} + 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 --source-snapshot 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 --source-snapshot on the command line with a + fully specified name; + ◆ set the property netapp/location; + ◆ set the property netapp/region. + + To set the volume attribute: + ◆ provide the argument --source-snapshot on the command line with a + fully specified name. + + --source-snapshot=SOURCE_SNAPSHOT + ID of the snapshot or fully qualified identifier for the snapshot. + + To set the snapshot attribute: + ▸ provide the argument --source-snapshot on the command line. + + Volume resource - The full name of the Source Volume that the Backup is + based on', Format: + projects/{projects_id}/locations/{location}/volumes/{volume_id} 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 --source-volume on the command line with a fully + specified name; + ◆ provide the argument --volume 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 --source-volume on the command line with a fully + specified name; + ◆ provide the argument --volume on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location; + ◆ set the property netapp/region. + + --source-volume=SOURCE_VOLUME + ID of the volume or fully qualified identifier for the volume. + + To set the volume attribute: + ▸ provide the argument --source-volume on the command line; + ▸ provide the argument --volume on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/netapp/backup-vaults/backups/delete b/gcloud/beta/netapp/backup-vaults/backups/delete new file mode 100644 index 000000000..1fa900e09 --- /dev/null +++ b/gcloud/beta/netapp/backup-vaults/backups/delete @@ -0,0 +1,101 @@ +NAME + gcloud beta netapp backup-vaults backups delete - delete a Cloud NetApp + Backup + +SYNOPSIS + gcloud beta netapp backup-vaults backups delete + (BACKUP : --location=LOCATION) [--async] [--backup-vault=BACKUP_VAULT] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Delete a Cloud NetApp Backup. + +EXAMPLES + The following command deletes a Backup named BACKUP inside a backup vault + named BACKUP_VAULT using the required arguments: + + $ gcloud beta netapp backup-vaults backups delete BACKUP \ + --location=us-central1 --backup-vault=BACKUP_VAULT + + To delete a Backup named BACKUP asynchronously, run the following command: + + $ gcloud beta netapp backup-vaults backups delete BACKUP \ + --location=us-central1 --backup-vault=BACKUP_VAULT --async + +POSITIONAL ARGUMENTS + Backup resource - The Backup 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 backup 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 backup_vault attribute: + ◆ provide the argument backup on the command line with a fully + specified name; + ◆ provide the argument --backup-vault on the command line. + + This must be specified. + + BACKUP + ID of the backup or fully qualified identifier for the backup. + + To set the backup attribute: + ▸ provide the argument backup 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 of the backup. + + To set the location attribute: + ▸ provide the argument backup on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + Backup vault resource - The Backup Vault that the Backup is stored in 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 --backup-vault 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 --backup-vault on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location; + ◆ set the property netapp/region. + + --backup-vault=BACKUP_VAULT + ID of the backup_vault or fully qualified identifier for the + backup_vault. + + To set the backup_vault attribute: + ▸ provide the argument --backup-vault on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/netapp/backup-vaults/backups/describe b/gcloud/beta/netapp/backup-vaults/backups/describe new file mode 100644 index 000000000..c905b2949 --- /dev/null +++ b/gcloud/beta/netapp/backup-vaults/backups/describe @@ -0,0 +1,92 @@ +NAME + gcloud beta netapp backup-vaults backups describe - describe a Cloud NetApp + Backup + +SYNOPSIS + gcloud beta netapp backup-vaults backups describe + (BACKUP : --location=LOCATION) [--backup-vault=BACKUP_VAULT] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Describe a Cloud NetApp Backup. + +EXAMPLES + The following command describes a Backup named BACKUP in the given location + and backup vault: + + $ gcloud beta netapp backup-vaults backups describe NAME \ + --location=us-central1 --backup-vault=BACKUP_VAULT + +POSITIONAL ARGUMENTS + Backup resource - The Backup to describe. The arguments in this group can + be used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument backup 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 backup_vault attribute: + ◆ provide the argument backup on the command line with a fully + specified name; + ◆ provide the argument --backup-vault on the command line. + + This must be specified. + + BACKUP + ID of the backup or fully qualified identifier for the backup. + + To set the backup attribute: + ▸ provide the argument backup 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 of the backup. + + To set the location attribute: + ▸ provide the argument backup on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +FLAGS + Backup vault resource - The Backup Vault that the Backup is stored in 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 --backup-vault 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 --backup-vault on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location; + ◆ set the property netapp/region. + + --backup-vault=BACKUP_VAULT + ID of the backup_vault or fully qualified identifier for the + backup_vault. + + To set the backup_vault attribute: + ▸ provide the argument --backup-vault on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/netapp/backup-vaults/backups/help b/gcloud/beta/netapp/backup-vaults/backups/help new file mode 100644 index 000000000..612501ec2 --- /dev/null +++ b/gcloud/beta/netapp/backup-vaults/backups/help @@ -0,0 +1,36 @@ +NAME + gcloud beta netapp backup-vaults backups - create and manage Cloud NetApp + Backups + +SYNOPSIS + gcloud beta netapp backup-vaults backups COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create and manage Cloud NetApp Backups. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (BETA) Create a Cloud NetApp Backup. + + delete + (BETA) Delete a Cloud NetApp Backup. + + describe + (BETA) Describe a Cloud NetApp Backup. + + list + (BETA) List Cloud NetApp Backups. + + update + (BETA) Update a Cloud NetApp Backup. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/game/servers/realms/list b/gcloud/beta/netapp/backup-vaults/backups/list similarity index 53% rename from gcloud/beta/game/servers/realms/list rename to gcloud/beta/netapp/backup-vaults/backups/list index 6e237f862..3ff3fc9e5 100644 --- a/gcloud/beta/game/servers/realms/list +++ b/gcloud/beta/netapp/backup-vaults/backups/list @@ -1,39 +1,68 @@ NAME - gcloud beta game servers realms list - list Realms + gcloud beta netapp backup-vaults backups list - list Cloud NetApp Backups SYNOPSIS - gcloud beta game servers realms list [--location=LOCATION] - [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] - [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + gcloud beta netapp backup-vaults backups list [--backup-vault=BACKUP_VAULT] + [--location=LOCATION] [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) List Cloud Game Server Realms. + (BETA) Lists Cloud NetApp Backups. EXAMPLES - To see the list of all Realms in project 'my-project' and location - 'my-location', run: + The following command lists all Backups in the given location and Backup + Vault named BACKUP_VAULT: - $ gcloud beta game servers realms list --project=my-project \ - --location=my-location + $ gcloud beta netapp backup-vaults backups list \ + --location=us-central1 --backup-vault=BACKUP_VAULT FLAGS - Location resource - Cloud Game Servers Location of the Realms to list. - This represents a Cloud resource. (NOTE) Some attributes are not given + Backup vault resource - The Backup Vault that the Backup is stored in 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 --backup-vault 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 --backup-vault on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location; + ◆ set the property netapp/region. + + --backup-vault=BACKUP_VAULT + ID of the backup_vault or fully qualified identifier for the + backup_vault. + + To set the backup_vault attribute: + ▸ provide the argument --backup-vault on the command line. + + Location resource - The location in which to list Backups. 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 game_services/location with a fully specified name; - ◆ set the property core/project; - ◆ provide the argument --project on the command line. + ◆ uses all locations by default. with a fully specified name; + ◆ set the property netapp/location with a fully specified name; + ◆ set the property netapp/region with a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. --location=LOCATION ID of the location or fully qualified identifier for the location. To set the location attribute: ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. + ▸ uses all locations by default.; + ▸ set the property netapp/location; + ▸ set the property netapp/region. LIST COMMAND FLAGS --filter=EXPRESSION @@ -75,15 +104,6 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. -API REFERENCE - This command uses the gameservices/v1beta API. The full documentation for - this API can be found at: https://cloud.google.com/solutions/gaming/ - NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud game servers realms list - - $ gcloud alpha game servers realms list + This command is currently in beta and might change without notice. diff --git a/gcloud/beta/netapp/backup-vaults/backups/update b/gcloud/beta/netapp/backup-vaults/backups/update new file mode 100644 index 000000000..03023b4d9 --- /dev/null +++ b/gcloud/beta/netapp/backup-vaults/backups/update @@ -0,0 +1,129 @@ +NAME + gcloud beta netapp backup-vaults backups update - update a Cloud NetApp + Backup + +SYNOPSIS + gcloud beta netapp backup-vaults backups update + (BACKUP : --location=LOCATION) [--async] [--backup-vault=BACKUP_VAULT] + [--description=DESCRIPTION] [--update-labels=[KEY=VALUE,...]] + [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Update a Cloud NetApp Backup and its specified parameters. + +EXAMPLES + The following command updates a Backup named BACKUP and its specified + parameters: + + $ gcloud beta netapp backup-vaults backups update NAME \ + --location=us-central1 --description="new description" + +POSITIONAL ARGUMENTS + Backup resource - The Backup to update The arguments in this group can be + used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument backup 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 backup_vault attribute: + ◆ provide the argument backup on the command line with a fully + specified name; + ◆ provide the argument --backup-vault on the command line. + + This must be specified. + + BACKUP + ID of the backup or fully qualified identifier for the backup. + + To set the backup attribute: + ▸ provide the argument backup 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 of the backup. + + To set the location attribute: + ▸ provide the argument backup on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + Backup vault resource - The Backup Vault that the Backup is stored in 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 --backup-vault 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 --backup-vault on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location; + ◆ set the property netapp/region. + + --backup-vault=BACKUP_VAULT + ID of the backup_vault or fully qualified identifier for the + backup_vault. + + To set the backup_vault attribute: + ▸ provide the argument --backup-vault on the command line. + + --description=DESCRIPTION + A description of the Cloud NetApp Backup + + --update-labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to update. If a label exists, its value + is modified. Otherwise, a new label is created. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + At most one of these can be specified: + + --clear-labels + Remove all labels. If --update-labels is also specified then + --clear-labels is applied first. + + For example, to remove all labels: + + $ gcloud beta netapp backup-vaults backups update --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud beta netapp backup-vaults backups update --clear-labels \ + --update-labels foo=bar,baz=qux + + --remove-labels=[KEY,...] + List of label keys to remove. If a label does not exist it is + silently ignored. If --update-labels is also specified then + --update-labels is applied first. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/netapp/backup-vaults/help b/gcloud/beta/netapp/backup-vaults/help index f09f9943d..321b80cd3 100644 --- a/gcloud/beta/netapp/backup-vaults/help +++ b/gcloud/beta/netapp/backup-vaults/help @@ -13,6 +13,12 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. +GROUPS + GROUP is one of the following: + + backups + (BETA) Create and manage Cloud NetApp Backups. + COMMANDS COMMAND is one of the following: diff --git a/gcloud/beta/netapp/volumes/create b/gcloud/beta/netapp/volumes/create index 8bb0ee0b4..379ce3fed 100644 --- a/gcloud/beta/netapp/volumes/create +++ b/gcloud/beta/netapp/volumes/create @@ -5,6 +5,9 @@ SYNOPSIS gcloud beta netapp volumes create (VOLUME : --location=LOCATION) --capacity=CAPACITY --protocols=PROTOCOL,[PROTOCOL,...] --share-name=SHARE_NAME --storage-pool=STORAGE_POOL [--async] + [--backup-config=[backup-policies=BACKUP-POLICIES], + [backup-vault=BACKUP-VAULT], + [enable-scheduled-backups=ENABLE-SCHEDULED-BACKUPS]] [--description=DESCRIPTION] [--enable-kerberos=ENABLE_KERBEROS] [--export-policy=[access-type=ACCESS-TYPE], [allowed-clients=ALLOWED-CLIENTS],[has-root-access=HAS-ROOT-ACCESS], @@ -29,7 +32,9 @@ SYNOPSIS [--snapshot-weekly=[day=DAY], [hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP]] [--source-snapshot=SOURCE_SNAPSHOT] - [--unix-permissions=UNIX_PERMISSIONS] [GCLOUD_WIDE_FLAG ...] + [--unix-permissions=UNIX_PERMISSIONS] + [--source-backup=SOURCE_BACKUP : --backup_vault=BACKUP_VAULT] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Create a Cloud NetApp Volume @@ -127,6 +132,19 @@ OPTIONAL FLAGS Return immediately, without waiting for the operation in progress to complete. + --backup-config=[backup-policies=BACKUP-POLICIES],[backup-vault=BACKUP-VAULT],[enable-scheduled-backups=ENABLE-SCHEDULED-BACKUPS] + Backup Config contains backup related config on a volume. + + Backup Config will have the following format + `--backup-config=backup-policies=BACKUP_POLICIES, + backup-vault=BACKUP_VAULT_NAME, + enable-scheduled-backups=ENABLE_SCHEDULED_BACKUPS + + backup-policies is a pound-separated (#) list of backup policy names, + backup-vault can include a single backup-vault resource name, and + enable-scheduled-backups is a Boolean value indicating whether or not + scheduled backups are enabled on the volume. + --description=DESCRIPTION A description of the Cloud NetApp Volume @@ -226,6 +244,41 @@ OPTIONAL FLAGS Unix permissions the mount point will be created with. Unix permissions are only applicable with NFS protocol only + Backup resource - The source Backup to create the Volume from. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument --source-backup 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 --source-backup on the command line with a fully + specified name; + ◆ set the property netapp/location; + ◆ set the property netapp/region. + + --source-backup=SOURCE_BACKUP + ID of the backup or fully qualified identifier for the backup. + + To set the backup attribute: + ▸ provide the argument --source-backup on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --backup_vault=BACKUP_VAULT + The Backup Vault of the backup. + + To set the backup_vault attribute: + ▸ provide the argument --source-backup on the command line with a + fully specified name; + ▸ provide the argument --backup_vault on the command line; + ▸ provide the argument --backup-vault 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, diff --git a/gcloud/beta/netapp/volumes/update b/gcloud/beta/netapp/volumes/update index 05c0f2ccb..3df25907b 100644 --- a/gcloud/beta/netapp/volumes/update +++ b/gcloud/beta/netapp/volumes/update @@ -3,6 +3,9 @@ NAME SYNOPSIS gcloud beta netapp volumes update (VOLUME : --location=LOCATION) [--async] + [--backup-config=[backup-policies=BACKUP-POLICIES], + [backup-vault=BACKUP-VAULT], + [enable-scheduled-backups=ENABLE-SCHEDULED-BACKUPS]] [--capacity=CAPACITY] [--description=DESCRIPTION] [--enable-kerberos=ENABLE_KERBEROS] [--export-policy=[access-type=ACCESS-TYPE], @@ -30,7 +33,9 @@ SYNOPSIS [hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP]] [--source-snapshot=SOURCE_SNAPSHOT] [--storage-pool=STORAGE_POOL] [--unix-permissions=UNIX_PERMISSIONS] [--update-labels=[KEY=VALUE,...]] - [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + [--clear-labels | --remove-labels=[KEY,...]] + [--source-backup=SOURCE_BACKUP : --backup_vault=BACKUP_VAULT] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Update a Cloud NetApp Volume and its specified parameters @@ -81,6 +86,19 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --backup-config=[backup-policies=BACKUP-POLICIES],[backup-vault=BACKUP-VAULT],[enable-scheduled-backups=ENABLE-SCHEDULED-BACKUPS] + Backup Config contains backup related config on a volume. + + Backup Config will have the following format + `--backup-config=backup-policies=BACKUP_POLICIES, + backup-vault=BACKUP_VAULT_NAME, + enable-scheduled-backups=ENABLE_SCHEDULED_BACKUPS + + backup-policies is a pound-separated (#) list of backup policy names, + backup-vault can include a single backup-vault resource name, and + enable-scheduled-backups is a Boolean value indicating whether or not + scheduled backups are enabled on the volume. + --capacity=CAPACITY The desired capacity of the Volume in GiB or TiB units.If no capacity unit is specified, GiB is assumed. @@ -236,6 +254,41 @@ FLAGS silently ignored. If --update-labels is also specified then --update-labels is applied first. + Backup resource - The source Backup to create the Volume from. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument --source-backup 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 --source-backup on the command line with a fully + specified name; + ◆ set the property netapp/location; + ◆ set the property netapp/region. + + --source-backup=SOURCE_BACKUP + ID of the backup or fully qualified identifier for the backup. + + To set the backup attribute: + ▸ provide the argument --source-backup on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --backup_vault=BACKUP_VAULT + The Backup Vault of the backup. + + To set the backup_vault attribute: + ▸ provide the argument --source-backup on the command line with a + fully specified name; + ▸ provide the argument --backup_vault on the command line; + ▸ provide the argument --backup-vault 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, diff --git a/gcloud/beta/services/vpc-peerings/enable-vpc-service-controls b/gcloud/beta/services/vpc-peerings/enable-vpc-service-controls index 1a2c4dada..e5550f286 100644 --- a/gcloud/beta/services/vpc-peerings/enable-vpc-service-controls +++ b/gcloud/beta/services/vpc-peerings/enable-vpc-service-controls @@ -9,15 +9,35 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) This command enables VPC Service Controls for the peering - connection. + (BETA) This command configures IPv4 routes and DNS zones applicable to a + service producer VPC network (for example, servicenetworking). The route + and DNS configuration match those recommended for using the + restricted.googleapis.com VIP: - The local default route (destination 0.0.0.0/0, next hop default internet - gateway) is deleted in the service producer VPC network. After deletion, - the service producer VPC network can import a custom default route from the - peering connection to the customer VPC network. This requires that the - customer VPC network be configured to export custom routes. The custom - default route cannot have an associated network tag. + When enabled, Google Cloud makes the following route configuration changes + in the service producer VPC network: Google Cloud removes the IPv4 default + route (destination 0.0.0.0/0, next hop default internet gateway). Google + Cloud then creates an IPv4 route for destination 199.36.153.4/30 using the + default internet gateway next hop. + + When enabled, Google Cloud also creates Cloud DNS managed private zones and + authorizes those zones for the service producer VPC network. The zones + include googleapis.com, pkg.dev, gcr.io, and other necessary domains or + host names for Google APIs and services that are compatible with VPC + Service Controls. Record data in the zones resolves all host names to + 199.36.153.4, 199.36.153.5, 199.36.153.6, and 199.36.153.7. + + When disabled, Google Cloud makes the following route configuration changes + in the service producer VPC network: Google Cloud restores a default route + (destination 0.0.0.0/0, next hop default internet gateway). Google Cloud + also deletes the Cloud DNS managed private zones that provided the host + name overrides. + + While enabled, the service producer VPC network can still import static and + dynamic routes from the peered customer network if you enable custom route + export. These custom routes can include a default route. For this reason, + this command is not to be used solely as a means for preventing access to + the internet. EXAMPLES To enable VPC Service Controls for a connection peering a network called diff --git a/gcloud/beta/tasks/cmek-config/describe b/gcloud/beta/tasks/cmek-config/describe new file mode 100644 index 000000000..73597ff11 --- /dev/null +++ b/gcloud/beta/tasks/cmek-config/describe @@ -0,0 +1,36 @@ +NAME + gcloud beta tasks cmek-config describe - get CMEK configuration for Cloud + Tasks in the specified location + +SYNOPSIS + gcloud beta tasks cmek-config describe --location=LOCATION + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Get CMEK configuration for Cloud Tasks in the specified location. + +EXAMPLES + To get a CMEK config: + + $ gcloud beta tasks cmek-config describe --location=my-location + +REQUIRED FLAGS + --location=LOCATION + Google Cloud location for the KMS key. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --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 tasks cmek-config describe + + $ gcloud alpha tasks cmek-config describe + diff --git a/gcloud/beta/tasks/cmek-config/help b/gcloud/beta/tasks/cmek-config/help new file mode 100644 index 000000000..507950026 --- /dev/null +++ b/gcloud/beta/tasks/cmek-config/help @@ -0,0 +1,34 @@ +NAME + gcloud beta tasks cmek-config - get or change CMEK configuration for Cloud + Tasks + +SYNOPSIS + gcloud beta tasks cmek-config COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Get or change CMEK configuration for Cloud Tasks. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + (BETA) Get CMEK configuration for Cloud Tasks in the specified + location. + + update + (BETA) Enable, disable, or edit CMEK configuration for Cloud Tasks in + the specified location. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud tasks cmek-config + + $ gcloud alpha tasks cmek-config + diff --git a/gcloud/beta/tasks/cmek-config/update b/gcloud/beta/tasks/cmek-config/update new file mode 100644 index 000000000..d6ca2c547 --- /dev/null +++ b/gcloud/beta/tasks/cmek-config/update @@ -0,0 +1,68 @@ +NAME + gcloud beta tasks cmek-config update - enable, disable, or edit CMEK + configuration for Cloud Tasks in the specified location + +SYNOPSIS + gcloud beta tasks cmek-config update [--location=LOCATION] + [--clear-kms-key | [--kms-key-name=KMS_KEY_NAME + : --kms-keyring=KMS_KEYRING --kms-project=KMS_PROJECT]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Enable, disable, or edit CMEK configuration for Cloud Tasks in the + specified location. + +EXAMPLES + To update a CMEK config: + + $ gcloud beta tasks cmek-config update \ + --kms-key-name=projects/my-project/locations/my-location/\ + keyRings/my-keyring/cryptoKeys/key + +FLAGS + --location=LOCATION + Google Cloud location for the KMS key. + + Flags for Clearing or Updating CMEK Resource + + At most one of these can be specified: + + Flags for clearing CMEK Resource key. + + --clear-kms-key + Disables CMEK for Cloud Tasks in the specified location by clearing + the Cloud KMS cryptokey from the Cloud Tasks project and CMEK + configuration. + + Flags for Updating CMEK Resource key + + --kms-key-name=KMS_KEY_NAME + Fully qualified identifier for the key or just the key ID. The + latter requires that the --kms-keyring and --kms-project flags be + provided too. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --kms-keyring=KMS_KEYRING + KMS keyring of the KMS key. + + --kms-project=KMS_PROJECT + Google Cloud project for the KMS key. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --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 tasks cmek-config update + + $ gcloud alpha tasks cmek-config update + diff --git a/gcloud/beta/tasks/help b/gcloud/beta/tasks/help index f11025a34..afef4b4c4 100644 --- a/gcloud/beta/tasks/help +++ b/gcloud/beta/tasks/help @@ -15,6 +15,9 @@ GCLOUD WIDE FLAGS GROUPS GROUP is one of the following: + cmek-config + (BETA) Get or change CMEK configuration for Cloud Tasks. + locations (BETA) Get information about Cloud Tasks locations. diff --git a/gcloud/beta/workstations/clusters/create b/gcloud/beta/workstations/clusters/create index 0205677e5..d8c3cb29a 100644 --- a/gcloud/beta/workstations/clusters/create +++ b/gcloud/beta/workstations/clusters/create @@ -3,8 +3,9 @@ NAME SYNOPSIS gcloud beta workstations clusters create (CLUSTER : --region=REGION) - [--async] [--enable-private-endpoint] [--labels=[KEY=VALUE,...]] - [--network=NETWORK] [--subnetwork=SUBNETWORK] [GCLOUD_WIDE_FLAG ...] + [--async] [--domain=DOMAIN] [--enable-private-endpoint] + [--labels=[KEY=VALUE,...]] [--network=NETWORK] + [--subnetwork=SUBNETWORK] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Create a workstation cluster. @@ -59,6 +60,9 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --domain=DOMAIN + Domain used by Workstations for HTTP ingress. + --enable-private-endpoint Default is false. If specified, the cluster will be assigned an internal IP address to the Cluster Gateway. This isolates the cluster's diff --git a/gcloud/builds/help b/gcloud/builds/help index 0627cfce6..c2a00b74f 100644 --- a/gcloud/builds/help +++ b/gcloud/builds/help @@ -19,7 +19,7 @@ GROUPS Manage connections for Google Cloud Build. repositories - Manage repositories for Google Cloud Build. + Manage repositories for Cloud Build. triggers Create and manage build triggers for Google Cloud Build. @@ -43,7 +43,7 @@ COMMANDS Stream the logs for a build. submit - Submit a build using Google Cloud Build. + Submit a build using Cloud Build. NOTES These variants are also available: diff --git a/gcloud/builds/repositories/help b/gcloud/builds/repositories/help index 1aeaa1fd0..ac180ca70 100644 --- a/gcloud/builds/repositories/help +++ b/gcloud/builds/repositories/help @@ -1,11 +1,11 @@ NAME - gcloud builds repositories - manage repositories for Google Cloud Build + gcloud builds repositories - manage repositories for Cloud Build SYNOPSIS gcloud builds repositories COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Manage repositories for Google Cloud Build. + Manage repositories for Cloud Build. GCLOUD WIDE FLAGS These flags are available to all commands: --help. diff --git a/gcloud/builds/submit b/gcloud/builds/submit index 884ff050c..09c76b277 100644 --- a/gcloud/builds/submit +++ b/gcloud/builds/submit @@ -1,5 +1,5 @@ NAME - gcloud builds submit - submit a build using Google Cloud Build + gcloud builds submit - submit a build using Cloud Build SYNOPSIS gcloud builds submit [[SOURCE] --no-source] [--async] [--no-cache] @@ -16,7 +16,7 @@ SYNOPSIS | --tag=TAG, -t TAG] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Submit a build using Google Cloud Build. + Submit a build using Cloud Build. When the builds/use_kaniko property is True, builds submitted with --tag will use Kaniko (https://github.com/GoogleContainerTools/kaniko) to execute @@ -42,6 +42,20 @@ EXAMPLES $ gcloud builds submit "source.tgz" --tag=gcr.io/my-project/image \ --async + To submit a build with source from a Git repository + https://github.com/owner/repo: + + $ gcloud builds submit "https://github.com/owner/repo" \ + --git-source-revision=main --config=config.yaml + + To submit a build with source from a 2nd-gen Cloud Build repository + resource + projects/my-project/locations/us-west1/connections/my-conn/repositories/my-repo: + + $ gcloud builds submit \ + "projects/my-project/locations/us-west1/connections/my-conn/repo\ + sitories/my-repo" --revision=main + POSITIONAL ARGUMENTS At most one of these can be specified: @@ -79,10 +93,10 @@ FLAGS --dir=DIR Directory, relative to the source root, in which to run the build. This - is used when the build source is a 2nd-gen Google Cloud Build - repository resource. This must be a relative path. If a step's dir is - specified and is an absolute path, this value is ignored for that - step's execution. + is used when the build source is a 2nd-gen Cloud Build repository + resource. This must be a relative path. If a step's dir is specified + and is an absolute path, this value is ignored for that step's + execution. --disk-size=DISK_SIZE Machine disk size (GB) to run the build. @@ -136,7 +150,7 @@ FLAGS --revision=REVISION Revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref to run the build. This is used when the - build source is a 2nd-gen Google Cloud Build repository resource. + build source is a 2nd-gen Cloud Build repository resource. Cloud Build uses git fetch to fetch the revision from the Git repository; therefore make sure that the string you provide for diff --git a/gcloud/builds/triggers/help b/gcloud/builds/triggers/help index cee86f819..2c9da68ae 100644 --- a/gcloud/builds/triggers/help +++ b/gcloud/builds/triggers/help @@ -35,7 +35,7 @@ COMMANDS Import a build trigger. list - List Google Cloud Build triggers for a project. + List Cloud Build triggers for a project. run Run a build trigger. diff --git a/gcloud/builds/triggers/list b/gcloud/builds/triggers/list index f3383ce3c..fd7a15d03 100644 --- a/gcloud/builds/triggers/list +++ b/gcloud/builds/triggers/list @@ -1,6 +1,5 @@ NAME - gcloud builds triggers list - list Google Cloud Build triggers for a - project + gcloud builds triggers list - list Cloud Build triggers for a project SYNOPSIS gcloud builds triggers list [--region=REGION] [--filter=EXPRESSION] @@ -8,7 +7,7 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - List Google Cloud Build triggers for a project. + List Cloud Build triggers for a project. EXAMPLES To list build triggers, run: diff --git a/gcloud/builds/triggers/update/bitbucketserver b/gcloud/builds/triggers/update/bitbucketserver index eaaa8db78..c20ce118a 100644 --- a/gcloud/builds/triggers/update/bitbucketserver +++ b/gcloud/builds/triggers/update/bitbucketserver @@ -1,6 +1,6 @@ NAME gcloud builds triggers update bitbucketserver - updates Bitbucket Server - trigger used by Google Cloud Build + trigger used by Cloud Build SYNOPSIS gcloud builds triggers update bitbucketserver (TRIGGER : --region=REGION) @@ -20,7 +20,7 @@ SYNOPSIS | --update-substitutions=[KEY=VALUE,...]) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Updates Bitbucket Server trigger used by Google Cloud Build. + Updates Bitbucket Server trigger used by Cloud Build. EXAMPLES To update the branch pattern of the trigger: diff --git a/gcloud/builds/triggers/update/cloud-source-repositories b/gcloud/builds/triggers/update/cloud-source-repositories index 4eec0f6c1..759bb1238 100644 --- a/gcloud/builds/triggers/update/cloud-source-repositories +++ b/gcloud/builds/triggers/update/cloud-source-repositories @@ -1,6 +1,6 @@ NAME gcloud builds triggers update cloud-source-repositories - updates Cloud - Source Repositories trigger used by Google Cloud Build + Source Repositories trigger used by Cloud Build SYNOPSIS gcloud builds triggers update cloud-source-repositories @@ -16,7 +16,7 @@ SYNOPSIS | --update-substitutions=[KEY=VALUE,...]) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Updates Cloud Source Repositories trigger used by Google Cloud Build. + Updates Cloud Source Repositories trigger used by Cloud Build. EXAMPLES To update the branch pattern of the trigger: diff --git a/gcloud/builds/triggers/update/github b/gcloud/builds/triggers/update/github index 8ed114851..3fbf03f16 100644 --- a/gcloud/builds/triggers/update/github +++ b/gcloud/builds/triggers/update/github @@ -1,6 +1,6 @@ NAME - gcloud builds triggers update github - update GitHub trigger used by Google - Cloud Build + gcloud builds triggers update github - update GitHub trigger used by Cloud + Build SYNOPSIS gcloud builds triggers update github (TRIGGER : --region=REGION) @@ -20,7 +20,7 @@ SYNOPSIS --repo-name=REPO_NAME --repo-owner=REPO_OWNER) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Update GitHub trigger used by Google Cloud Build. + Update GitHub trigger used by Cloud Build. EXAMPLES To update the branch pattern of the trigger: diff --git a/gcloud/builds/triggers/update/gitlab b/gcloud/builds/triggers/update/gitlab index 53022e526..bf4551d20 100644 --- a/gcloud/builds/triggers/update/gitlab +++ b/gcloud/builds/triggers/update/gitlab @@ -1,6 +1,6 @@ NAME - gcloud builds triggers update gitlab - updates GitLab trigger used by - Google Cloud Build + gcloud builds triggers update gitlab - updates GitLab trigger used by Cloud + Build SYNOPSIS gcloud builds triggers update gitlab (TRIGGER : --region=REGION) @@ -17,7 +17,7 @@ SYNOPSIS | --update-substitutions=[KEY=VALUE,...]) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Updates GitLab trigger used by Google Cloud Build. + Updates GitLab trigger used by Cloud Build. EXAMPLES To update the branch pattern of the trigger: diff --git a/gcloud/builds/triggers/update/help b/gcloud/builds/triggers/update/help index 64e5b8e97..a5529e459 100644 --- a/gcloud/builds/triggers/update/help +++ b/gcloud/builds/triggers/update/help @@ -16,25 +16,25 @@ COMMANDS COMMAND is one of the following: bitbucketserver - Updates Bitbucket Server trigger used by Google Cloud Build. + Updates Bitbucket Server trigger used by Cloud Build. cloud-source-repositories - Updates Cloud Source Repositories trigger used by Google Cloud Build. + Updates Cloud Source Repositories trigger used by Cloud Build. github - Update GitHub trigger used by Google Cloud Build. + Update GitHub trigger used by Cloud Build. gitlab - Updates GitLab trigger used by Google Cloud Build. + Updates GitLab trigger used by Cloud Build. manual - Updates a manual trigger used by Google Cloud Build. + Updates a manual trigger used by Cloud Build. pubsub - Update a Pub/Sub trigger used by Google Cloud Build. + Update a Pub/Sub trigger used by Cloud Build. webhook - Update a Webhook trigger used by Google Cloud Build. + Update a Webhook trigger used by Cloud Build. NOTES These variants are also available: diff --git a/gcloud/builds/triggers/update/manual b/gcloud/builds/triggers/update/manual index ccb5a8b47..411c9108b 100644 --- a/gcloud/builds/triggers/update/manual +++ b/gcloud/builds/triggers/update/manual @@ -1,6 +1,6 @@ NAME gcloud builds triggers update manual - updates a manual trigger used by - Google Cloud Build + Cloud Build SYNOPSIS gcloud builds triggers update manual (TRIGGER : --region=REGION) @@ -17,7 +17,7 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Updates a manual trigger used by Google Cloud Build. + Updates a manual trigger used by Cloud Build. EXAMPLES To update the branch from which the trigger clones: diff --git a/gcloud/builds/triggers/update/pubsub b/gcloud/builds/triggers/update/pubsub index 4dc3ceb77..e1972e16a 100644 --- a/gcloud/builds/triggers/update/pubsub +++ b/gcloud/builds/triggers/update/pubsub @@ -1,6 +1,6 @@ NAME gcloud builds triggers update pubsub - update a Pub/Sub trigger used by - Google Cloud Build + Cloud Build SYNOPSIS gcloud builds triggers update pubsub (TRIGGER : --region=REGION) @@ -18,7 +18,7 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Update a Pub/Sub trigger used by Google Cloud Build. + Update a Pub/Sub trigger used by Cloud Build. EXAMPLES To update the branch from which the trigger clones: diff --git a/gcloud/builds/triggers/update/webhook b/gcloud/builds/triggers/update/webhook index a55e84ddd..0bb7197e8 100644 --- a/gcloud/builds/triggers/update/webhook +++ b/gcloud/builds/triggers/update/webhook @@ -1,6 +1,6 @@ NAME gcloud builds triggers update webhook - update a Webhook trigger used by - Google Cloud Build + Cloud Build SYNOPSIS gcloud builds triggers update webhook (TRIGGER : --region=REGION) @@ -18,7 +18,7 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Update a Webhook trigger used by Google Cloud Build. + Update a Webhook trigger used by Cloud Build. EXAMPLES To update the branch from which the trigger clones: diff --git a/gcloud/builds/worker-pools/create b/gcloud/builds/worker-pools/create index 61344fe72..d784e3e24 100644 --- a/gcloud/builds/worker-pools/create +++ b/gcloud/builds/worker-pools/create @@ -1,6 +1,6 @@ NAME - gcloud builds worker-pools create - create a worker pool for use by Google - Cloud Build + gcloud builds worker-pools create - create a worker pool for use by Cloud + Build SYNOPSIS gcloud builds worker-pools create WORKER_POOL --region=REGION @@ -10,7 +10,7 @@ SYNOPSIS --worker-machine-type=WORKER_MACHINE_TYPE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Create a worker pool for use by Google Cloud Build. + Create a worker pool for use by Cloud Build. EXAMPLES To create a worker pool named wp1 in region us-central1, run: diff --git a/gcloud/builds/worker-pools/delete b/gcloud/builds/worker-pools/delete index c9f3688e5..26fa5c8e9 100644 --- a/gcloud/builds/worker-pools/delete +++ b/gcloud/builds/worker-pools/delete @@ -1,13 +1,12 @@ NAME - gcloud builds worker-pools delete - delete a worker pool from Google Cloud - Build + gcloud builds worker-pools delete - delete a worker pool from Cloud Build SYNOPSIS gcloud builds worker-pools delete WORKER_POOL --region=REGION [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Delete a worker pool from Google Cloud Build. + Delete a worker pool from Cloud Build. EXAMPLES To delete a worker pool named wp1 in region us-central1, run: diff --git a/gcloud/builds/worker-pools/describe b/gcloud/builds/worker-pools/describe index 56d915540..11ce87e5a 100644 --- a/gcloud/builds/worker-pools/describe +++ b/gcloud/builds/worker-pools/describe @@ -1,13 +1,13 @@ NAME - gcloud builds worker-pools describe - describe a worker pool used by Google - Cloud Build + gcloud builds worker-pools describe - describe a worker pool used by Cloud + Build SYNOPSIS gcloud builds worker-pools describe WORKER_POOL --region=REGION [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Describe a worker pool used by Google Cloud Build. + Describe a worker pool used by Cloud Build. EXAMPLES To get information about a worker pool named wp1 in region us-central1, diff --git a/gcloud/builds/worker-pools/help b/gcloud/builds/worker-pools/help index 864d2b6f9..3cf00607c 100644 --- a/gcloud/builds/worker-pools/help +++ b/gcloud/builds/worker-pools/help @@ -16,19 +16,19 @@ COMMANDS COMMAND is one of the following: create - Create a worker pool for use by Google Cloud Build. + Create a worker pool for use by Cloud Build. delete - Delete a worker pool from Google Cloud Build. + Delete a worker pool from Cloud Build. describe - Describe a worker pool used by Google Cloud Build. + Describe a worker pool used by Cloud Build. list List all worker pools in a Google Cloud project. update - Update a worker pool used by Google Cloud Build. + Update a worker pool used by Cloud Build. NOTES These variants are also available: diff --git a/gcloud/builds/worker-pools/update b/gcloud/builds/worker-pools/update index 2131afcfc..375782fbb 100644 --- a/gcloud/builds/worker-pools/update +++ b/gcloud/builds/worker-pools/update @@ -1,6 +1,6 @@ NAME - gcloud builds worker-pools update - update a worker pool used by Google - Cloud Build + gcloud builds worker-pools update - update a worker pool used by Cloud + Build SYNOPSIS gcloud builds worker-pools update WORKER_POOL --region=REGION @@ -10,7 +10,7 @@ SYNOPSIS | --no-public-egress) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Update a worker pool used by Google Cloud Build. + Update a worker pool used by Cloud Build. EXAMPLES To change the machine type and disk size of workers in a worker pool named diff --git a/gcloud/compute/snapshots/create b/gcloud/compute/snapshots/create index aeb8472e7..69ad31d0f 100644 --- a/gcloud/compute/snapshots/create +++ b/gcloud/compute/snapshots/create @@ -5,8 +5,10 @@ SYNOPSIS gcloud compute snapshots create NAME [--async] [--chain-name=CHAIN_NAME] [--csek-key-file=FILE] [--description=DESCRIPTION] [--guest-flush] [--labels=[KEY=VALUE,...]] [--snapshot-type=SNAPSHOT_TYPE] - [--source-disk=SOURCE_DISK] [--source-disk-key-file=FILE] - [--storage-location=LOCATION] + [--source-disk=SOURCE_DISK] + [--source-disk-for-recovery-checkpoint=SOURCE_DISK_FOR_RECOVERY_CHECKPOINT] + [--source-disk-for-recovery-checkpoint-region=SOURCE_DISK_FOR_RECOVERY_CHECKPOINT_REGION] + [--source-disk-key-file=FILE] [--storage-location=LOCATION] [--source-disk-region=SOURCE_DISK_REGION | --source-disk-zone=SOURCE_DISK_ZONE] [GCLOUD_WIDE_FLAG ...] @@ -76,6 +78,17 @@ FLAGS disk. For example: https://www.googleapis.com/compute/v1/projects/MY-PROJECT/zones/MY-ZONE/disks/MY-DISK + --source-disk-for-recovery-checkpoint=SOURCE_DISK_FOR_RECOVERY_CHECKPOINT + Source disk whose recovery checkpoint used to create the snapshot. To + create a snapshot from the recovery checkpoint of a source disk in a + different project, specify the full path to the source disk. For + example: projects/MY-PROJECT/regions/MY-REGION/disks/MY-DISK + + --source-disk-for-recovery-checkpoint-region=SOURCE_DISK_FOR_RECOVERY_CHECKPOINT_REGION + Region of the source disk for recovery checkpoint to operate on. + Overrides the default compute/region property value for this command + invocation. + --source-disk-key-file=FILE Path to the customer-supplied encryption key of the source disk. Required if the source disk is protected by a customer-supplied diff --git a/gcloud/config/get b/gcloud/config/get index 612486311..45a4f9c0b 100644 --- a/gcloud/config/get +++ b/gcloud/config/get @@ -298,10 +298,6 @@ AVAILABLE PROPERTIES Private Service Connect usage, see https://cloud.google.com/vpc/docs/configure-private-service-connect-apis#using-endpoints - config - Overrides API endpoint for gcloud blueprints command group. - Defaults to https://config.googleapis.com/ - container Overrides API endpoint for gcloud container command group. Defaults to https://container.googleapis.com/ @@ -382,10 +378,6 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud firestore command group. Defaults to https://firestore.googleapis.com/ - gameservices - Overrides API endpoint for gcloud gamer command group. Defaults to - https://gameservices.googleapis.com/ - genomics Overrides API endpoint for gcloud genomics command group. Defaults to https://genomics.googleapis.com/ @@ -920,24 +912,6 @@ AVAILABLE PROPERTIES fall back to this value, if set. To see valid choices, run gcloud beta functions regions list. - game_services - default_deployment - Default deployment to use when working with Cloud Game Services - list configs. When a --deployment flag is required in a list - command but not provided, the command will fall back to this value - which envokes aggregated list from the backend. - - default_realm - Default realm to use when working with Cloud Game Services list - clusters. When a --realm flag is required in a list command but not - provided, the command will fall back to this value which envokes - aggregated list from the backend. - - location - Default location to use when working with Cloud Game Services - resources. When a --location flag is required but not provided, the - command will fall back to this value. - gcloudignore enabled If True, do not upload .gcloudignore files (see $ gcloud topic diff --git a/gcloud/config/help b/gcloud/config/help index 4a8bb3b81..bdf9f8871 100644 --- a/gcloud/config/help +++ b/gcloud/config/help @@ -330,10 +330,6 @@ AVAILABLE PROPERTIES Private Service Connect usage, see https://cloud.google.com/vpc/docs/configure-private-service-connect-apis#using-endpoints - config - Overrides API endpoint for gcloud blueprints command group. - Defaults to https://config.googleapis.com/ - container Overrides API endpoint for gcloud container command group. Defaults to https://container.googleapis.com/ @@ -414,10 +410,6 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud firestore command group. Defaults to https://firestore.googleapis.com/ - gameservices - Overrides API endpoint for gcloud gamer command group. Defaults to - https://gameservices.googleapis.com/ - genomics Overrides API endpoint for gcloud genomics command group. Defaults to https://genomics.googleapis.com/ @@ -952,24 +944,6 @@ AVAILABLE PROPERTIES fall back to this value, if set. To see valid choices, run gcloud beta functions regions list. - game_services - default_deployment - Default deployment to use when working with Cloud Game Services - list configs. When a --deployment flag is required in a list - command but not provided, the command will fall back to this value - which envokes aggregated list from the backend. - - default_realm - Default realm to use when working with Cloud Game Services list - clusters. When a --realm flag is required in a list command but not - provided, the command will fall back to this value which envokes - aggregated list from the backend. - - location - Default location to use when working with Cloud Game Services - resources. When a --location flag is required but not provided, the - command will fall back to this value. - gcloudignore enabled If True, do not upload .gcloudignore files (see $ gcloud topic diff --git a/gcloud/config/list b/gcloud/config/list index b7456a66a..88a85ca63 100644 --- a/gcloud/config/list +++ b/gcloud/config/list @@ -342,10 +342,6 @@ AVAILABLE PROPERTIES Private Service Connect usage, see https://cloud.google.com/vpc/docs/configure-private-service-connect-apis#using-endpoints - config - Overrides API endpoint for gcloud blueprints command group. - Defaults to https://config.googleapis.com/ - container Overrides API endpoint for gcloud container command group. Defaults to https://container.googleapis.com/ @@ -426,10 +422,6 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud firestore command group. Defaults to https://firestore.googleapis.com/ - gameservices - Overrides API endpoint for gcloud gamer command group. Defaults to - https://gameservices.googleapis.com/ - genomics Overrides API endpoint for gcloud genomics command group. Defaults to https://genomics.googleapis.com/ @@ -964,24 +956,6 @@ AVAILABLE PROPERTIES fall back to this value, if set. To see valid choices, run gcloud beta functions regions list. - game_services - default_deployment - Default deployment to use when working with Cloud Game Services - list configs. When a --deployment flag is required in a list - command but not provided, the command will fall back to this value - which envokes aggregated list from the backend. - - default_realm - Default realm to use when working with Cloud Game Services list - clusters. When a --realm flag is required in a list command but not - provided, the command will fall back to this value which envokes - aggregated list from the backend. - - location - Default location to use when working with Cloud Game Services - resources. When a --location flag is required but not provided, the - command will fall back to this value. - gcloudignore enabled If True, do not upload .gcloudignore files (see $ gcloud topic diff --git a/gcloud/config/set b/gcloud/config/set index 63dcdf150..7e6329bbb 100644 --- a/gcloud/config/set +++ b/gcloud/config/set @@ -345,10 +345,6 @@ AVAILABLE PROPERTIES Private Service Connect usage, see https://cloud.google.com/vpc/docs/configure-private-service-connect-apis#using-endpoints - config - Overrides API endpoint for gcloud blueprints command group. - Defaults to https://config.googleapis.com/ - container Overrides API endpoint for gcloud container command group. Defaults to https://container.googleapis.com/ @@ -429,10 +425,6 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud firestore command group. Defaults to https://firestore.googleapis.com/ - gameservices - Overrides API endpoint for gcloud gamer command group. Defaults to - https://gameservices.googleapis.com/ - genomics Overrides API endpoint for gcloud genomics command group. Defaults to https://genomics.googleapis.com/ @@ -967,24 +959,6 @@ AVAILABLE PROPERTIES fall back to this value, if set. To see valid choices, run gcloud beta functions regions list. - game_services - default_deployment - Default deployment to use when working with Cloud Game Services - list configs. When a --deployment flag is required in a list - command but not provided, the command will fall back to this value - which envokes aggregated list from the backend. - - default_realm - Default realm to use when working with Cloud Game Services list - clusters. When a --realm flag is required in a list command but not - provided, the command will fall back to this value which envokes - aggregated list from the backend. - - location - Default location to use when working with Cloud Game Services - resources. When a --location flag is required but not provided, the - command will fall back to this value. - gcloudignore enabled If True, do not upload .gcloudignore files (see $ gcloud topic diff --git a/gcloud/config/unset b/gcloud/config/unset index b3db835d7..acf21fbab 100644 --- a/gcloud/config/unset +++ b/gcloud/config/unset @@ -306,10 +306,6 @@ AVAILABLE PROPERTIES Private Service Connect usage, see https://cloud.google.com/vpc/docs/configure-private-service-connect-apis#using-endpoints - config - Overrides API endpoint for gcloud blueprints command group. - Defaults to https://config.googleapis.com/ - container Overrides API endpoint for gcloud container command group. Defaults to https://container.googleapis.com/ @@ -390,10 +386,6 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud firestore command group. Defaults to https://firestore.googleapis.com/ - gameservices - Overrides API endpoint for gcloud gamer command group. Defaults to - https://gameservices.googleapis.com/ - genomics Overrides API endpoint for gcloud genomics command group. Defaults to https://genomics.googleapis.com/ @@ -928,24 +920,6 @@ AVAILABLE PROPERTIES fall back to this value, if set. To see valid choices, run gcloud beta functions regions list. - game_services - default_deployment - Default deployment to use when working with Cloud Game Services - list configs. When a --deployment flag is required in a list - command but not provided, the command will fall back to this value - which envokes aggregated list from the backend. - - default_realm - Default realm to use when working with Cloud Game Services list - clusters. When a --realm flag is required in a list command but not - provided, the command will fall back to this value which envokes - aggregated list from the backend. - - location - Default location to use when working with Cloud Game Services - resources. When a --location flag is required but not provided, the - command will fall back to this value. - gcloudignore enabled If True, do not upload .gcloudignore files (see $ gcloud topic diff --git a/gcloud/container/aws/clusters/create b/gcloud/container/aws/clusters/create index cc492183c..387431485 100644 --- a/gcloud/container/aws/clusters/create +++ b/gcloud/container/aws/clusters/create @@ -180,7 +180,8 @@ OPTIONAL FLAGS --main-volume-throughput=MAIN_VOLUME_THROUGHPUT Throughput to provision for the main volume, in MiB/s. Only valid if - the volume type is GP3. + the volume type is GP3. If volume type is GP3 and throughput is not + provided, it defaults to 125. --main-volume-type=MAIN_VOLUME_TYPE Type of the main volume. MAIN_VOLUME_TYPE must be one of: gp2, gp3. @@ -203,7 +204,8 @@ OPTIONAL FLAGS --root-volume-throughput=ROOT_VOLUME_THROUGHPUT Throughput to provision for the root volume, in MiB/s. Only valid if - the volume type is GP3. + the volume type is GP3. If volume type is GP3 and throughput is not + provided, it defaults to 125. --root-volume-type=ROOT_VOLUME_TYPE Type of the root volume. ROOT_VOLUME_TYPE must be one of: gp2, gp3. diff --git a/gcloud/container/aws/clusters/update b/gcloud/container/aws/clusters/update index 73d124881..0e22e6455 100644 --- a/gcloud/container/aws/clusters/update +++ b/gcloud/container/aws/clusters/update @@ -127,7 +127,8 @@ FLAGS --root-volume-throughput=ROOT_VOLUME_THROUGHPUT Throughput to provision for the root volume, in MiB/s. Only valid if - the volume type is GP3. + the volume type is GP3. If volume type is GP3 and throughput is not + provided, it defaults to 125. --root-volume-type=ROOT_VOLUME_TYPE Type of the root volume. ROOT_VOLUME_TYPE must be one of: gp2, gp3. diff --git a/gcloud/container/aws/node-pools/create b/gcloud/container/aws/node-pools/create index 2ecb3d2d4..52f000db5 100644 --- a/gcloud/container/aws/node-pools/create +++ b/gcloud/container/aws/node-pools/create @@ -150,7 +150,8 @@ OPTIONAL FLAGS --root-volume-throughput=ROOT_VOLUME_THROUGHPUT Throughput to provision for the root volume, in MiB/s. Only valid if - the volume type is GP3. + the volume type is GP3. If volume type is GP3 and throughput is not + provided, it defaults to 125. --root-volume-type=ROOT_VOLUME_TYPE Type of the root volume. ROOT_VOLUME_TYPE must be one of: gp2, gp3. diff --git a/gcloud/container/aws/node-pools/update b/gcloud/container/aws/node-pools/update index a55ba0989..11a448c29 100644 --- a/gcloud/container/aws/node-pools/update +++ b/gcloud/container/aws/node-pools/update @@ -114,7 +114,8 @@ FLAGS --root-volume-throughput=ROOT_VOLUME_THROUGHPUT Throughput to provision for the root volume, in MiB/s. Only valid if - the volume type is GP3. + the volume type is GP3. If volume type is GP3 and throughput is not + provided, it defaults to 125. --root-volume-type=ROOT_VOLUME_TYPE Type of the root volume. ROOT_VOLUME_TYPE must be one of: gp2, gp3. diff --git a/gcloud/container/fleet/identity-service/apply b/gcloud/container/fleet/identity-service/apply index 34037fcee..e473cf175 100644 --- a/gcloud/container/fleet/identity-service/apply +++ b/gcloud/container/fleet/identity-service/apply @@ -3,8 +3,9 @@ NAME Feature Spec SYNOPSIS - gcloud container fleet identity-service apply --config=CONFIG - [--membership=MEMBERSHIP : --location=LOCATION] [GCLOUD_WIDE_FLAG ...] + gcloud container fleet identity-service apply + ([--config=CONFIG : [--membership=MEMBERSHIP : --location=LOCATION]]) + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Applies the authentication configuration to the Identity Service feature @@ -15,46 +16,50 @@ DESCRIPTION you run this command. EXAMPLES - To apply an Identity Service configuration for a membership, run: + To apply an Identity Service configuration to a membership, run: $ gcloud container fleet identity-service apply \ --membership=MEMBERSHIP_NAME \ --config=/path/to/identity-service.yaml REQUIRED FLAGS - --config=CONFIG - The path to the identity-service.yaml config file. + At least one of these must be specified: -OPTIONAL FLAGS - Membership resource - The group of arguments defining a membership. 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 --membership on the command line with a fully - specified name; - ◆ provide the argument --project on the command line; - ◆ set the property core/project. - - --membership=MEMBERSHIP - ID of the membership or fully qualified identifier for the - membership. - - To set the membership attribute: - ▸ provide the argument --membership on the command line. + --config=CONFIG + The path to an identity-service.yaml config file. This flag argument must be specified if any of the other arguments in this group are specified. - --location=LOCATION - Location for the membership. + Membership resource - The group of arguments defining a membership. 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 location attribute: - ▸ provide the argument --membership on the command line with a - fully specified name; - ▸ provide the argument --location on the command line; - ▸ set the property gkehub/location. + To set the project attribute: + ▸ provide the argument --membership on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --membership=MEMBERSHIP + ID of the membership or fully qualified identifier for the + membership. + + To set the membership attribute: + ▫ provide the argument --membership on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the membership. + + To set the location attribute: + ▫ provide the argument --membership on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/container/hub/identity-service/apply b/gcloud/container/hub/identity-service/apply index 02403544b..2f88d9343 100644 --- a/gcloud/container/hub/identity-service/apply +++ b/gcloud/container/hub/identity-service/apply @@ -3,8 +3,9 @@ NAME Feature Spec SYNOPSIS - gcloud container hub identity-service apply --config=CONFIG - [--membership=MEMBERSHIP : --location=LOCATION] [GCLOUD_WIDE_FLAG ...] + gcloud container hub identity-service apply + ([--config=CONFIG : [--membership=MEMBERSHIP : --location=LOCATION]]) + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Applies the authentication configuration to the Identity Service feature @@ -15,46 +16,50 @@ DESCRIPTION you run this command. EXAMPLES - To apply an Identity Service configuration for a membership, run: + To apply an Identity Service configuration to a membership, run: $ gcloud container hub identity-service apply \ --membership=MEMBERSHIP_NAME \ --config=/path/to/identity-service.yaml REQUIRED FLAGS - --config=CONFIG - The path to the identity-service.yaml config file. + At least one of these must be specified: -OPTIONAL FLAGS - Membership resource - The group of arguments defining a membership. 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 --membership on the command line with a fully - specified name; - ◆ provide the argument --project on the command line; - ◆ set the property core/project. - - --membership=MEMBERSHIP - ID of the membership or fully qualified identifier for the - membership. - - To set the membership attribute: - ▸ provide the argument --membership on the command line. + --config=CONFIG + The path to an identity-service.yaml config file. This flag argument must be specified if any of the other arguments in this group are specified. - --location=LOCATION - Location for the membership. + Membership resource - The group of arguments defining a membership. 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 location attribute: - ▸ provide the argument --membership on the command line with a - fully specified name; - ▸ provide the argument --location on the command line; - ▸ set the property gkehub/location. + To set the project attribute: + ▸ provide the argument --membership on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --membership=MEMBERSHIP + ID of the membership or fully qualified identifier for the + membership. + + To set the membership attribute: + ▫ provide the argument --membership on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the membership. + + To set the location attribute: + ▫ provide the argument --membership on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/database-migration/connection-profiles/create/cloudsql b/gcloud/database-migration/connection-profiles/create/cloudsql index a49bfb86c..f3eb2fe9b 100644 --- a/gcloud/database-migration/connection-profiles/create/cloudsql +++ b/gcloud/database-migration/connection-profiles/create/cloudsql @@ -77,8 +77,11 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --database-version=DATABASE_VERSION Database engine type and version. DATABASE_VERSION must be one of: - MYSQL_5_7, MYSQL_5_6, MYSQL_8_0, POSTGRES_9_6, POSTGRES_10, - POSTGRES_11, POSTGRES_12, POSTGRES_13, POSTGRES_14, POSTGRES_15. + MYSQL_5_7, MYSQL_5_6, MYSQL_8_0, MYSQL_8_0_18, MYSQL_8_0_26, + MYSQL_8_0_27, MYSQL_8_0_28, MYSQL_8_0_30, MYSQL_8_0_31, MYSQL_8_0_32, + MYSQL_8_0_33, MYSQL_8_0_34, MYSQL_8_0_35, MYSQL_8_0_36, POSTGRES_9_6, + POSTGRES_10, POSTGRES_11, POSTGRES_12, POSTGRES_13, POSTGRES_14, + POSTGRES_15. Connection profile resource - Database Migration Service source connection profile ID. This represents a Cloud resource. (NOTE) Some attributes are diff --git a/gcloud/game/help b/gcloud/game/help deleted file mode 100644 index d51b1740b..000000000 --- a/gcloud/game/help +++ /dev/null @@ -1,33 +0,0 @@ -NAME - gcloud game - managed Cloud Game Services - -SYNOPSIS - gcloud game GROUP [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Managed Cloud Game Services. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -GROUPS - GROUP is one of the following: - - locations - Query Cloud Game Services Locations. - - operations - Deploy and manage Cloud Game Services Operations. - - servers - Managed Cloud Game Servers. - -NOTES - These variants are also available: - - $ gcloud alpha game - - $ gcloud beta game - diff --git a/gcloud/game/locations/describe b/gcloud/game/locations/describe deleted file mode 100644 index 0afa6f0dc..000000000 --- a/gcloud/game/locations/describe +++ /dev/null @@ -1,52 +0,0 @@ -NAME - gcloud game locations describe - describe a Location - -SYNOPSIS - gcloud game locations describe [LOCATION] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Describe a Cloud Game Services Location. - -EXAMPLES - To describe location 'my-location', run: - - $ gcloud game locations describe my-location - -POSITIONAL ARGUMENTS - Location resource - Cloud Game Services Location to describe. This - represents a Cloud resource. (NOTE) Some attributes are not given - arguments in this group but can be set in other ways. - - To set the project attribute: - ◆ provide the argument location on the command line with a fully - specified name; - ◆ set the property game_services/location with a fully specified name; - ◆ set the property core/project; - ◆ provide the argument --project on the command line. - - [LOCATION] - ID of the location or fully qualified identifier for the location. - - To set the location attribute: - ▸ provide the argument location on the command line; - ▸ set the property game_services/location. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the gameservices/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - These variants are also available: - - $ gcloud alpha game locations describe - - $ gcloud beta game locations describe - diff --git a/gcloud/game/locations/help b/gcloud/game/locations/help deleted file mode 100644 index 109147e56..000000000 --- a/gcloud/game/locations/help +++ /dev/null @@ -1,30 +0,0 @@ -NAME - gcloud game locations - query Cloud Game Services Locations - -SYNOPSIS - gcloud game locations COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Query Cloud Game Services Locations. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -COMMANDS - COMMAND is one of the following: - - describe - Describe a Location. - - list - List Locations. - -NOTES - These variants are also available: - - $ gcloud alpha game locations - - $ gcloud beta game locations - diff --git a/gcloud/game/locations/list b/gcloud/game/locations/list deleted file mode 100644 index d7e01cda8..000000000 --- a/gcloud/game/locations/list +++ /dev/null @@ -1,67 +0,0 @@ -NAME - gcloud game locations list - list Locations - -SYNOPSIS - gcloud game locations list [--filter=EXPRESSION] [--limit=LIMIT] - [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - List Cloud Game Services Locations. - -EXAMPLES - To see the list of all Locations, run: - - $ gcloud game locations list - -LIST COMMAND FLAGS - --filter=EXPRESSION - Apply a Boolean filter EXPRESSION to each resource item to be listed. - If the expression evaluates True, then that item is listed. For more - details and examples of filter expressions, run $ gcloud topic filters. - This flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --limit=LIMIT - Maximum number of resources to list. The default is unlimited. This - flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --page-size=PAGE_SIZE - Some services group resource list output into pages. This flag - specifies the maximum number of resources per page. The default is - determined by the service if it supports paging, otherwise it is - unlimited (no paging). Paging may be applied before or after --filter - and --limit depending on the service. - - --sort-by=[FIELD,...] - Comma-separated list of resource field key names to sort by. The - default order is ascending. Prefix a field with ``~'' for descending - order on that field. This flag interacts with other flags that are - applied in this order: --flatten, --sort-by, --filter, --limit. - - --uri - Print a list of resource URIs instead of the default output, and change - the command output to a list of URIs. If this flag is used with - --format, the formatting is applied on this URI list. To display URIs - alongside other keys instead, use the uri() transform. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the gameservices/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - These variants are also available: - - $ gcloud alpha game locations list - - $ gcloud beta game locations list - diff --git a/gcloud/game/operations/describe b/gcloud/game/operations/describe deleted file mode 100644 index 60f742ffe..000000000 --- a/gcloud/game/operations/describe +++ /dev/null @@ -1,68 +0,0 @@ -NAME - gcloud game operations describe - describe an Operation - -SYNOPSIS - gcloud game operations describe (OPERATION : --location=LOCATION) - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Describe a Cloud Game Services Operation. - -EXAMPLES - To describe operation 'my-operation' in project 'my-project' and location - 'my-location', run: - - $ gcloud game operations describe my-operation \ - --project=my-project --location=my-location - -POSITIONAL ARGUMENTS - Operation resource - Cloud Game Services Operation to describe. The - arguments in this group can be used to specify the attributes of this - resource. (NOTE) Some attributes are not given arguments in this group but - can be set in other ways. - - To set the project attribute: - ◆ provide the argument operation on the command line with a fully - specified name; - ◆ set the property core/project; - ◆ provide the argument --project on the command line. - - This must be specified. - - OPERATION - ID of the 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 - Google Cloud location. - - 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; - ▸ set the property game_services/location. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the gameservices/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - These variants are also available: - - $ gcloud alpha game operations describe - - $ gcloud beta game operations describe - diff --git a/gcloud/game/operations/help b/gcloud/game/operations/help deleted file mode 100644 index 5a9f3cf6d..000000000 --- a/gcloud/game/operations/help +++ /dev/null @@ -1,30 +0,0 @@ -NAME - gcloud game operations - deploy and manage Cloud Game Services Operations - -SYNOPSIS - gcloud game operations COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Deploy and manage Cloud Game Services Operations. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -COMMANDS - COMMAND is one of the following: - - describe - Describe an Operation. - - list - List Operations. - -NOTES - These variants are also available: - - $ gcloud alpha game operations - - $ gcloud beta game operations - diff --git a/gcloud/game/operations/list b/gcloud/game/operations/list deleted file mode 100644 index 23cbf3ffb..000000000 --- a/gcloud/game/operations/list +++ /dev/null @@ -1,88 +0,0 @@ -NAME - gcloud game operations list - list Operations - -SYNOPSIS - gcloud game operations list [--location=LOCATION] [--filter=EXPRESSION] - [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - List Cloud Game Services Operations. - -EXAMPLES - To see the list of all Operations in project 'my-project' and location - 'my-location', run: - - $ gcloud game operations list --project=my-project \ - --location=my-location - -FLAGS - Location resource - Cloud Game Services Location of the Operations to - list. 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 game_services/location 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; - ▸ set the property game_services/location. - -LIST COMMAND FLAGS - --filter=EXPRESSION - Apply a Boolean filter EXPRESSION to each resource item to be listed. - If the expression evaluates True, then that item is listed. For more - details and examples of filter expressions, run $ gcloud topic filters. - This flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --limit=LIMIT - Maximum number of resources to list. The default is unlimited. This - flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --page-size=PAGE_SIZE - Some services group resource list output into pages. This flag - specifies the maximum number of resources per page. The default is - determined by the service if it supports paging, otherwise it is - unlimited (no paging). Paging may be applied before or after --filter - and --limit depending on the service. - - --sort-by=[FIELD,...] - Comma-separated list of resource field key names to sort by. The - default order is ascending. Prefix a field with ``~'' for descending - order on that field. This flag interacts with other flags that are - applied in this order: --flatten, --sort-by, --filter, --limit. - - --uri - Print a list of resource URIs instead of the default output, and change - the command output to a list of URIs. If this flag is used with - --format, the formatting is applied on this URI list. To display URIs - alongside other keys instead, use the uri() transform. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the gameservices/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - These variants are also available: - - $ gcloud alpha game operations list - - $ gcloud beta game operations list - diff --git a/gcloud/game/servers/clusters/create b/gcloud/game/servers/clusters/create deleted file mode 100644 index 7d75c0af7..000000000 --- a/gcloud/game/servers/clusters/create +++ /dev/null @@ -1,125 +0,0 @@ -NAME - gcloud game servers clusters create - create a Game Server Cluster - -SYNOPSIS - gcloud game servers clusters create - (CLUSTER : --location=LOCATION --realm=REALM) --dry-run - --gke-cluster=GKE_CLUSTER --namespace=NAMESPACE - [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] - [--preview-time=PREVIEW_TIME] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Create a Cloud Game Server Cluster. - -EXAMPLES - To create Game Server Cluster 'my-cluster' in project 'my-project', realm - 'my-realm', and location in 'my-location' run: - - $ gcloud game servers clusters create my-cluster \ - --project=my-project --realm=my-realm --location=my-location \ - --gke-cluster=projects/my-project/locations/my-location/\ - clusters/my-gke-cluster --namespace=default --labels=a=x,b=y \ - --no-dry-run - - To preview Game Server Cluster creation for 'my-cluster' in project - 'my-project', realm 'my-realm', and location in 'my-location' run: - - $ gcloud game servers clusters create my-cluster \ - --project=my-project --realm=my-realm --location=my-location \ - --gke-cluster=projects/my-project/locations/my-location/\ - clusters/my-gke-cluster --namespace=default --labels=a=x,b=y \ - --dry-run - -POSITIONAL ARGUMENTS - Game server cluster resource - Cloud Game Server Cluster 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 cluster 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. - - CLUSTER - ID of the game server cluster or fully qualified identifier for the - game server cluster. - - To set the cluster attribute: - ▸ provide the argument cluster on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --location=LOCATION - Google Cloud location. - - To set the location attribute: - ▸ provide the argument cluster on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - - --realm=REALM - Cloud Game Servers Realm. - - To set the realm attribute: - ▸ provide the argument cluster on the command line with a fully - specified name; - ▸ provide the argument --realm on the command line. - -REQUIRED FLAGS - --dry-run - Validate the creation, but do not execute it. - - --gke-cluster=GKE_CLUSTER - Full or partial name of a cluster in Google Kubernetes Engine (GKE) - where the game server cluster is installed, using the format: - 'projects/{project_id}/locations/{location_id}/clusters/{cluster_id}'. - Note, the location of the GKE cluster can be either a region or a zone. - Example: 'projects/my-project/locations/us-central1/clusters/test'. If - project and location are not specified, the project and location of the - Game Server Cluster resource are used to generate the full name of the - GKE cluster. - - --namespace=NAMESPACE - Namespace for Kubernetes API server endpoint. - -OPTIONAL FLAGS - --description=DESCRIPTION - Game server cluster description. - - --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. - - --preview-time=PREVIEW_TIME - This attribute is only relevant for preview (--dry-run). It is used to - validate the state for a future time. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 gameservices/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - These variants are also available: - - $ gcloud alpha game servers clusters create - - $ gcloud beta game servers clusters create - diff --git a/gcloud/game/servers/clusters/delete b/gcloud/game/servers/clusters/delete deleted file mode 100644 index f9a3ef57e..000000000 --- a/gcloud/game/servers/clusters/delete +++ /dev/null @@ -1,94 +0,0 @@ -NAME - gcloud game servers clusters delete - delete a Game Server Cluster - -SYNOPSIS - gcloud game servers clusters delete - (CLUSTER : --location=LOCATION --realm=REALM) --dry-run - [--preview-time=PREVIEW_TIME] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Delete a Game Server Cluster. - -EXAMPLES - To delete Game Server Cluster 'my-cluster' in project 'my-project', realm - 'my-realm', and location 'my-location' run: - - $ gcloud game servers clusters delete my-cluster \ - --project=my-project --realm=my-realm --location=my-location \ - --no-dry-run - - To preview deletion of Game Server Cluster 'my-cluster' in project - 'my-project', realm 'my-realm', and location 'my-location' run: - - $ gcloud game servers clusters delete my-cluster \ - --project=my-project --realm=my-realm --location=my-location \ - --dry-run - -POSITIONAL ARGUMENTS - Game Server Cluster resource - Cloud Game Server Cluster 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 cluster on the command line with a fully - specified name; - ◆ provide the argument --project on the command line; - ◆ set the property core/project. - - This must be specified. - - CLUSTER - ID of the Game Server Cluster or fully qualified identifier for the - Game Server Cluster. - - To set the name attribute: - ▸ provide the argument cluster on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --location=LOCATION - Google Cloud location. - - To set the location attribute: - ▸ provide the argument cluster on the command line with a fully - specified name; - ▸ provide the argument --location on the command line. - - --realm=REALM - Cloud Game Server Realm. - - To set the realm attribute: - ▸ provide the argument cluster on the command line with a fully - specified name; - ▸ provide the argument --realm on the command line. - -REQUIRED FLAGS - --dry-run - Validate the operation, but do not execute it. - -OPTIONAL FLAGS - --preview-time=PREVIEW_TIME - This attribute is only relevant for preview (--dry-run). It is used to - validate the state for a future time. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 gameservices API. The full documentation for this API - can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - These variants are also available: - - $ gcloud alpha game servers clusters delete - - $ gcloud beta game servers clusters delete - diff --git a/gcloud/game/servers/clusters/describe b/gcloud/game/servers/clusters/describe deleted file mode 100644 index bf7046f4c..000000000 --- a/gcloud/game/servers/clusters/describe +++ /dev/null @@ -1,91 +0,0 @@ -NAME - gcloud game servers clusters describe - describe a Game Server Cluster - -SYNOPSIS - gcloud game servers clusters describe - (CLUSTER : --location=LOCATION --realm=REALM) - [--view=VIEW; default="basic"] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Describe a Cloud Game Server Cluster. - -EXAMPLES - To describe Game Server Cluster 'my-cluster' in project 'my-project', realm - 'my-realm', and location 'my-location', run: - - $ gcloud game servers clusters describe my-cluster \ - --project=my-project --realm=my-realm --location=my-location - -POSITIONAL ARGUMENTS - Game server cluster resource - Cloud Game Server Cluster 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 cluster 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. - - CLUSTER - ID of the game server cluster or fully qualified identifier for the - game server cluster. - - To set the cluster attribute: - ▸ provide the argument cluster on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --location=LOCATION - Google Cloud location. - - To set the location attribute: - ▸ provide the argument cluster on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - - --realm=REALM - Cloud Game Servers Realm. - - To set the realm attribute: - ▸ provide the argument cluster on the command line with a fully - specified name; - ▸ provide the argument --realm on the command line. - -FLAGS - --view=VIEW; default="basic" - There are two possible views, 'basic' and 'full'. The default view is - 'basic'. VIEW must be one of: - - basic - Include info of the game server cluster resource, but not the - registered Kubernetes cluster's info such as versions or provider. - - full - Include info for both the game server cluster resource and - registered Kuberentes cluster. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 gameservices/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - These variants are also available: - - $ gcloud alpha game servers clusters describe - - $ gcloud beta game servers clusters describe - diff --git a/gcloud/game/servers/clusters/help b/gcloud/game/servers/clusters/help deleted file mode 100644 index c04bc51ee..000000000 --- a/gcloud/game/servers/clusters/help +++ /dev/null @@ -1,39 +0,0 @@ -NAME - gcloud game servers clusters - deploy and manage Cloud Game Server Clusters - -SYNOPSIS - gcloud game servers clusters COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Deploy and manage Cloud Game Server Clusters. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -COMMANDS - COMMAND is one of the following: - - create - Create a Game Server Cluster. - - delete - Delete a Game Server Cluster. - - describe - Describe a Game Server Cluster. - - list - List Game Server Clusters. - - update - Update a Game Server Cluster. - -NOTES - These variants are also available: - - $ gcloud alpha game servers clusters - - $ gcloud beta game servers clusters - diff --git a/gcloud/game/servers/clusters/list b/gcloud/game/servers/clusters/list deleted file mode 100644 index e9b002863..000000000 --- a/gcloud/game/servers/clusters/list +++ /dev/null @@ -1,114 +0,0 @@ -NAME - gcloud game servers clusters list - list Game Server Clusters - -SYNOPSIS - gcloud game servers clusters list [--view=VIEW; default="basic"] - [--location=LOCATION --realm=REALM] [--filter=EXPRESSION] - [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - List Cloud Game Server Clusters. - -EXAMPLES - To see the list of all Game Server Clusters in project 'my-project', realm - 'my-realm', and location 'my-location', run: - - $ gcloud game servers clusters list --project=my-project \ - --realm=my-realm --location=my-location - -FLAGS - --view=VIEW; default="basic" - There are two possible views, 'basic' and 'full'. The default view is - 'basic'. VIEW must be one of: - - basic - Include info of the game server cluster resource, but not the - registered Kubernetes cluster's info such as versions or provider. - - full - Include info for both the game server cluster resource and - registered Kuberentes cluster. - - Realm resource - Cloud Game Servers Realm of the Game Server Cluster to - list. 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 --realm on the command line with a fully - specified name; - ◆ set the property game_services/default_realm with a fully specified - name; - ◆ set the property core/project; - ◆ provide the argument --project on the command line. - - --location=LOCATION - Google Cloud location. - - To set the location attribute: - ▸ provide the argument --realm on the command line with a fully - specified name; - ▸ set the property game_services/default_realm with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - - --realm=REALM - ID of the realm or fully qualified identifier for the realm. - - To set the realm attribute: - ▸ provide the argument --realm on the command line; - ▸ set the property game_services/default_realm. - -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 gameservices/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - These variants are also available: - - $ gcloud alpha game servers clusters list - - $ gcloud beta game servers clusters list - diff --git a/gcloud/game/servers/clusters/update b/gcloud/game/servers/clusters/update deleted file mode 100644 index 0b0fe7df7..000000000 --- a/gcloud/game/servers/clusters/update +++ /dev/null @@ -1,129 +0,0 @@ -NAME - gcloud game servers clusters update - update a Game Server Cluster - -SYNOPSIS - gcloud game servers clusters update - (CLUSTER : --location=LOCATION --realm=REALM) --dry-run - [--description=DESCRIPTION] [--preview-time=PREVIEW_TIME] - [--update-labels=[KEY=VALUE,...]] - [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Update a Cloud Game Server Cluster. - -EXAMPLES - To update labels for Game Server Cluster 'my-cluster' in project - 'my-project', realm 'my-realm', and location in 'my-location' run: - - $ gcloud game servers clusters update my-cluster \ - --project=my-project --realm=my-realm --location=my-location \ - --update-labels="key1=val1" --no-dry-run - - To preview Game Server Cluster label update for 'my-cluster' in project - 'my-project', realm 'my-realm', and location in 'my-location' run: - - $ gcloud game servers clusters update my-cluster \ - --project=my-project --realm=my-realm --location=my-location \ - --update-labels="key1=val1" --dry-run - -POSITIONAL ARGUMENTS - Game server cluster resource - Cloud Game Server Cluster to update. The - arguments in this group can be used to specify the attributes of this - resource. (NOTE) Some attributes are not given arguments in this group but - can be set in other ways. - - To set the project attribute: - ◆ provide the argument cluster on the command line with a fully - specified name; - ◆ set the property core/project; - ◆ provide the argument --project on the command line. - - This must be specified. - - CLUSTER - ID of the game server cluster or fully qualified identifier for the - game server cluster. - - To set the cluster attribute: - ▸ provide the argument cluster on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --location=LOCATION - Google Cloud location. - - To set the location attribute: - ▸ provide the argument cluster on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - - --realm=REALM - Cloud Game Servers Realm. - - To set the realm attribute: - ▸ provide the argument cluster on the command line with a fully - specified name; - ▸ provide the argument --realm on the command line. - -REQUIRED FLAGS - --dry-run - Validate the changes, but do not execute it. - -OPTIONAL FLAGS - --description=DESCRIPTION - Description for the game server cluster. - - --preview-time=PREVIEW_TIME - This attribute is only relevant for preview (--dry-run). It is used to - validate the state for a future time. - - --update-labels=[KEY=VALUE,...] - List of label KEY=VALUE pairs to update. If a label exists, its value - is modified. Otherwise, a new label is created. - - Keys must start with a lowercase character and contain only hyphens - (-), underscores (_), lowercase characters, and numbers. Values must - contain only hyphens (-), underscores (_), lowercase characters, and - numbers. - - At most one of these can be specified: - - --clear-labels - Remove all labels. If --update-labels is also specified then - --clear-labels is applied first. - - For example, to remove all labels: - - $ gcloud game servers clusters update --clear-labels - - To remove all existing labels and create two new labels, foo and baz: - - $ gcloud game servers clusters update --clear-labels \ - --update-labels foo=bar,baz=qux - - --remove-labels=[KEY,...] - List of label keys to remove. If a label does not exist it is - silently ignored. If --update-labels is also specified then - --update-labels is applied first. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the gameservices/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - These variants are also available: - - $ gcloud alpha game servers clusters update - - $ gcloud beta game servers clusters update - diff --git a/gcloud/game/servers/configs/create b/gcloud/game/servers/configs/create deleted file mode 100644 index db8e7d8b8..000000000 --- a/gcloud/game/servers/configs/create +++ /dev/null @@ -1,139 +0,0 @@ -NAME - gcloud game servers configs create - create a Game Server Config - -SYNOPSIS - gcloud game servers configs create - (CONFIG : --deployment=DEPLOYMENT --location=LOCATION) - --fleet-configs-file=FLEET_CONFIGS_FILE [--async] - [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] - [--scaling-configs-file=SCALING_CONFIGS_FILE] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Create a Cloud Game Server Config for a Game Server Deployment. - -EXAMPLES - To create Game Server Config 'my-config' in project 'my-project', - deployment 'my-deployment', and location in 'global'(configs only support - the 'global' location) run: - - $ gcloud game servers configs create my-config \ - --project=my-project --deployment=my-deployment \ - --location=global --deployment=my-deployment \ - --description=description --labels=a=x,b=y \ - --fleet-configs-file=fleet_configs.json - -POSITIONAL ARGUMENTS - Game server config resource - Cloud Game Server Config 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 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. - - CONFIG - ID of the game server config or fully qualified identifier for the - game server config. - - To set the config attribute: - ▸ provide the argument config on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --deployment=DEPLOYMENT - Cloud Game Servers Deployment. - - To set the deployment attribute: - ▸ provide the argument config on the command line with a fully - specified name; - ▸ provide the argument --deployment on the command line. - - --location=LOCATION - Google Cloud location. - - To set the location attribute: - ▸ provide the argument config on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -REQUIRED FLAGS - --fleet-configs-file=FLEET_CONFIGS_FILE - Path to a JSON or YAML file that contains fleet configs. The fleet spec - field in configs file follows Agones Fleet custom resource. Please see - https://github.com/googleforgames/agones/blob/master/examples/simple-udp/fleet.yaml - for example and https://agones.dev/site/docs/reference/fleet/ for Fleet - Spec definition. - -OPTIONAL FLAGS - --async - Return immediately, without waiting for the operation in progress to - complete. - - --description=DESCRIPTION - Game server config description. - - --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. - - --scaling-configs-file=SCALING_CONFIGS_FILE - Path to a JSON or YAML file that contains scaling configs. The fleet - autoscaler spec field in configs file follows Agones Fleet Autoscaler - custom resource. Please see - https://github.com/googleforgames/agones/blob/master/examples/simple-udp/fleetautoscaler.yaml - for example and https://agones.dev/site/docs/reference/fleetautoscaler/ - for Fleet Autoscaler Spec definition. Scaling config file can also - specifies schedules. Contents of a sample yaml file: - - - fleetAutoscalerSpec: - policy: - type: Buffer - buffer: - bufferSize: 10 - minReplicas: 10 - maxReplicas: 20 - name: scaling-config-2 - schedules: - - startTime: '2020-01-01T01:00:00Z' - endTime: '2020-01-02T01:00:00Z' - cronSpec: '0 9 * * *' - cronJobDuration: 3600s - - fleetAutoscalerSpec: - policy: - type: Buffer - buffer: - bufferSize: 2 - minReplicas: 2 - maxReplicas: 4 - name: scaling-config-1 - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 gameservices/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - These variants are also available: - - $ gcloud alpha game servers configs create - - $ gcloud beta game servers configs create - diff --git a/gcloud/game/servers/configs/delete b/gcloud/game/servers/configs/delete deleted file mode 100644 index 55f557cba..000000000 --- a/gcloud/game/servers/configs/delete +++ /dev/null @@ -1,84 +0,0 @@ -NAME - gcloud game servers configs delete - delete a Game Server Config - -SYNOPSIS - gcloud game servers configs delete - (CONFIG : --deployment=DEPLOYMENT --location=LOCATION) [--async] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Delete a Cloud Game Server Config. - -EXAMPLES - To delete Game Server Config 'my-config' in project 'my-project', - deployment 'my-deployment', and location 'global'(configs only support the - 'global' location), run: - - $ gcloud game servers configs delete my-config \ - --project=my-project --deployment=deployment --location=global - -POSITIONAL ARGUMENTS - Game server config resource - Cloud Game Server Config 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 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. - - CONFIG - ID of the game server config or fully qualified identifier for the - game server config. - - To set the config attribute: - ▸ provide the argument config on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --deployment=DEPLOYMENT - Cloud Game Servers Deployment. - - To set the deployment attribute: - ▸ provide the argument config on the command line with a fully - specified name; - ▸ provide the argument --deployment on the command line. - - --location=LOCATION - Google Cloud location. - - To set the location attribute: - ▸ provide the argument config on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -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 gameservices/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - These variants are also available: - - $ gcloud alpha game servers configs delete - - $ gcloud beta game servers configs delete - diff --git a/gcloud/game/servers/configs/describe b/gcloud/game/servers/configs/describe deleted file mode 100644 index 989d855d8..000000000 --- a/gcloud/game/servers/configs/describe +++ /dev/null @@ -1,80 +0,0 @@ -NAME - gcloud game servers configs describe - describe a Game Server Config - -SYNOPSIS - gcloud game servers configs describe - (CONFIG : --deployment=DEPLOYMENT --location=LOCATION) - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Describe a Cloud Game Server Config. - -EXAMPLES - To describe Game Server Config 'my-config' in project 'my-project', - deployment 'my-deployment' and location 'global'(configs only support the - 'global' location), run: - - $ gcloud game servers configs describe my-config \ - --project=my-project --deployment=my-deployment \ - --location=global - -POSITIONAL ARGUMENTS - Game server config resource - Cloud Game Server Config 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 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. - - CONFIG - ID of the game server config or fully qualified identifier for the - game server config. - - To set the config attribute: - ▸ provide the argument config on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --deployment=DEPLOYMENT - Cloud Game Servers Deployment. - - To set the deployment attribute: - ▸ provide the argument config on the command line with a fully - specified name; - ▸ provide the argument --deployment on the command line. - - --location=LOCATION - Google Cloud location. - - To set the location attribute: - ▸ provide the argument config on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the gameservices/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - These variants are also available: - - $ gcloud alpha game servers configs describe - - $ gcloud beta game servers configs describe - diff --git a/gcloud/game/servers/configs/help b/gcloud/game/servers/configs/help deleted file mode 100644 index e9c986647..000000000 --- a/gcloud/game/servers/configs/help +++ /dev/null @@ -1,36 +0,0 @@ -NAME - gcloud game servers configs - deploy and manage Cloud Game Server Configs - -SYNOPSIS - gcloud game servers configs COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Deploy and manage Cloud Game Server Configs. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -COMMANDS - COMMAND is one of the following: - - create - Create a Game Server Config. - - delete - Delete a Game Server Config. - - describe - Describe a Game Server Config. - - list - List Configs. - -NOTES - These variants are also available: - - $ gcloud alpha game servers configs - - $ gcloud beta game servers configs - diff --git a/gcloud/game/servers/configs/list b/gcloud/game/servers/configs/list deleted file mode 100644 index 19482ec32..000000000 --- a/gcloud/game/servers/configs/list +++ /dev/null @@ -1,104 +0,0 @@ -NAME - gcloud game servers configs list - list Configs - -SYNOPSIS - gcloud game servers configs list - [--deployment=DEPLOYMENT --location=LOCATION] [--filter=EXPRESSION] - [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - List Cloud Game Server Configs. - -EXAMPLES - To see the list of all Game Server Configs in project 'my-project', - deployment 'my-deployment' and location 'global'(configs only support the - 'global' location), run: - - $ gcloud game servers configs list --project=my-project \ - --deployment=my-deployment --location=global - -FLAGS - Deployment resource - Cloud Game Server Deployment of the Game Server - Configs to list. 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 --deployment on the command line with a fully - specified name; - ◆ set the property game_services/default_deployment with a fully - specified name; - ◆ set the property core/project; - ◆ provide the argument --project on the command line. - - --deployment=DEPLOYMENT - ID of the deployment or fully qualified identifier for the - deployment. - - To set the deployment attribute: - ▸ provide the argument --deployment on the command line; - ▸ set the property game_services/default_deployment. - - --location=LOCATION - Google Cloud location. - - To set the location attribute: - ▸ provide the argument --deployment on the command line with a - fully specified name; - ▸ set the property game_services/default_deployment with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -LIST COMMAND FLAGS - --filter=EXPRESSION - Apply a Boolean filter EXPRESSION to each resource item to be listed. - If the expression evaluates True, then that item is listed. For more - details and examples of filter expressions, run $ gcloud topic filters. - This flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --limit=LIMIT - Maximum number of resources to list. The default is unlimited. This - flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --page-size=PAGE_SIZE - Some services group resource list output into pages. This flag - specifies the maximum number of resources per page. The default is - determined by the service if it supports paging, otherwise it is - unlimited (no paging). Paging may be applied before or after --filter - and --limit depending on the service. - - --sort-by=[FIELD,...] - Comma-separated list of resource field key names to sort by. The - default order is ascending. Prefix a field with ``~'' for descending - order on that field. This flag interacts with other flags that are - applied in this order: --flatten, --sort-by, --filter, --limit. - - --uri - Print a list of resource URIs instead of the default output, and change - the command output to a list of URIs. If this flag is used with - --format, the formatting is applied on this URI list. To display URIs - alongside other keys instead, use the uri() transform. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the gameservices/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - These variants are also available: - - $ gcloud alpha game servers configs list - - $ gcloud beta game servers configs list - diff --git a/gcloud/game/servers/deployments/create b/gcloud/game/servers/deployments/create deleted file mode 100644 index e72f8d635..000000000 --- a/gcloud/game/servers/deployments/create +++ /dev/null @@ -1,88 +0,0 @@ -NAME - gcloud game servers deployments create - create a Deployment - -SYNOPSIS - gcloud game servers deployments create (DEPLOYMENT : --location=LOCATION) - [--async] [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Create a Cloud Game Server Deployment. - -EXAMPLES - To create Game Server Deployment 'my-deployment' in project 'my-project' - and location in 'global'(deployments only support the 'global' location) - run: - - $ gcloud game servers deployments create my-deployment \ - --project=my-project --location=global \ - --description=description --labels=a=x,b=y - -POSITIONAL ARGUMENTS - Deployment resource - Cloud Game Server Deployment 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 deployment 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. - - DEPLOYMENT - ID of the deployment or fully qualified identifier for the - deployment. - - To set the deployment attribute: - ▸ provide the argument deployment 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 location. - - To set the location attribute: - ▸ provide the argument deployment on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -FLAGS - --async - Return immediately, without waiting for the operation in progress to - complete. - - --description=DESCRIPTION - Game server deployment description. - - --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 gameservices/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - These variants are also available: - - $ gcloud alpha game servers deployments create - - $ gcloud beta game servers deployments create - diff --git a/gcloud/game/servers/deployments/delete b/gcloud/game/servers/deployments/delete deleted file mode 100644 index 2625b42f7..000000000 --- a/gcloud/game/servers/deployments/delete +++ /dev/null @@ -1,74 +0,0 @@ -NAME - gcloud game servers deployments delete - delete a Deployment - -SYNOPSIS - gcloud game servers deployments delete (DEPLOYMENT : --location=LOCATION) - [--async] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Delete a Cloud Game Server Deployment. - -EXAMPLES - To delete Game Server Deployment 'my-deployment' in project 'my-project' - and location 'global'(deployments only support the 'global' location), run: - - $ gcloud game servers deployments delete my-deployment \ - --project=my-project --location=global - -POSITIONAL ARGUMENTS - Deployment resource - Cloud Game Server Deployment 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 deployment 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. - - DEPLOYMENT - ID of the deployment or fully qualified identifier for the - deployment. - - To set the deployment attribute: - ▸ provide the argument deployment 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 location. - - To set the location attribute: - ▸ provide the argument deployment on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -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 gameservices/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - These variants are also available: - - $ gcloud alpha game servers deployments delete - - $ gcloud beta game servers deployments delete - diff --git a/gcloud/game/servers/deployments/describe b/gcloud/game/servers/deployments/describe deleted file mode 100644 index 74cecbca5..000000000 --- a/gcloud/game/servers/deployments/describe +++ /dev/null @@ -1,69 +0,0 @@ -NAME - gcloud game servers deployments describe - describe a Deployment - -SYNOPSIS - gcloud game servers deployments describe (DEPLOYMENT : --location=LOCATION) - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Describe a Cloud Game Server Deployment. - -EXAMPLES - To describe Game Server Deployment 'my-deployment' in project 'my-project' - and location 'global'(deployments only support the 'global' location), run: - - $ gcloud game servers deployments describe my-deployment \ - --project=my-project --location=global - -POSITIONAL ARGUMENTS - Deployment resource - Cloud Game Server Deployment 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 deployment 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. - - DEPLOYMENT - ID of the deployment or fully qualified identifier for the - deployment. - - To set the deployment attribute: - ▸ provide the argument deployment 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 location. - - To set the location attribute: - ▸ provide the argument deployment on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the gameservices/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - These variants are also available: - - $ gcloud alpha game servers deployments describe - - $ gcloud beta game servers deployments describe - diff --git a/gcloud/game/servers/deployments/describe-rollout b/gcloud/game/servers/deployments/describe-rollout deleted file mode 100644 index 4e4f0f139..000000000 --- a/gcloud/game/servers/deployments/describe-rollout +++ /dev/null @@ -1,70 +0,0 @@ -NAME - gcloud game servers deployments describe-rollout - describe a Rollout - -SYNOPSIS - gcloud game servers deployments describe-rollout - (DEPLOYMENT : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Describe a Cloud Game Server Deployment Rollout. - -EXAMPLES - To describe the Rollout of Game Server Deployment 'my-deployment' in - project 'my-project', and location 'global'(deployments only support the - 'global' location), run: - - $ gcloud game servers deployments describe-rollout my-deployment \ - --project=my-project --location=global - -POSITIONAL ARGUMENTS - Deployment resource - Cloud Game Server Deployment Rollout 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 deployment 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. - - DEPLOYMENT - ID of the deployment or fully qualified identifier for the - deployment. - - To set the deployment attribute: - ▸ provide the argument deployment 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 location. - - To set the location attribute: - ▸ provide the argument deployment on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the gameservices/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - These variants are also available: - - $ gcloud alpha game servers deployments describe-rollout - - $ gcloud beta game servers deployments describe-rollout - diff --git a/gcloud/game/servers/deployments/fetch-state b/gcloud/game/servers/deployments/fetch-state deleted file mode 100644 index 79437c512..000000000 --- a/gcloud/game/servers/deployments/fetch-state +++ /dev/null @@ -1,71 +0,0 @@ -NAME - gcloud game servers deployments fetch-state - fetches the state of a - Deployment - -SYNOPSIS - gcloud game servers deployments fetch-state - (DEPLOYMENT : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Fetches a Cloud Game Server Deployment State from all clusters. - -EXAMPLES - To fetch the deployment state for Game Server Deployment 'my-deployment' in - project 'my-project' and location 'global'(deployments only support the - 'global' location), run: - - $ gcloud game servers deployments fetch-state my-deployment \ - --project=my-project --location=global - -POSITIONAL ARGUMENTS - Deployment resource - Cloud Game Server Deployment State to fetch. 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 deployment 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. - - DEPLOYMENT - ID of the deployment or fully qualified identifier for the - deployment. - - To set the deployment attribute: - ▸ provide the argument deployment 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 location. - - To set the location attribute: - ▸ provide the argument deployment on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the gameservices/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - These variants are also available: - - $ gcloud alpha game servers deployments fetch-state - - $ gcloud beta game servers deployments fetch-state - diff --git a/gcloud/game/servers/deployments/help b/gcloud/game/servers/deployments/help deleted file mode 100644 index 5dfcf778d..000000000 --- a/gcloud/game/servers/deployments/help +++ /dev/null @@ -1,49 +0,0 @@ -NAME - gcloud game servers deployments - deploy and manage Cloud Game Server - Deployments - -SYNOPSIS - gcloud game servers deployments COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Deploy and manage Cloud Game Server Deployments. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -COMMANDS - COMMAND is one of the following: - - create - Create a Deployment. - - delete - Delete a Deployment. - - describe - Describe a Deployment. - - describe-rollout - Describe a Rollout. - - fetch-state - Fetches the state of a Deployment. - - list - List Deployments. - - update - Update a Deployment. - - update-rollout - Update a Deployment Rollout. - -NOTES - These variants are also available: - - $ gcloud alpha game servers deployments - - $ gcloud beta game servers deployments - diff --git a/gcloud/game/servers/deployments/list b/gcloud/game/servers/deployments/list deleted file mode 100644 index 98d2962dd..000000000 --- a/gcloud/game/servers/deployments/list +++ /dev/null @@ -1,88 +0,0 @@ -NAME - gcloud game servers deployments list - list Deployments - -SYNOPSIS - gcloud game servers deployments list [--location=LOCATION] - [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] - [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - List Cloud Game Server Deployments. - -EXAMPLES - To see the list of all Game Server Deployments in project 'my-project' and - location 'global'(deployments only support the 'global' location), run: - - $ gcloud game servers deployments list --project=my-project \ - --location=global - -FLAGS - Location resource - Cloud Game Servers Location of the Deployments to - list. 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 game_services/location 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; - ▸ set the property game_services/location. - -LIST COMMAND FLAGS - --filter=EXPRESSION - Apply a Boolean filter EXPRESSION to each resource item to be listed. - If the expression evaluates True, then that item is listed. For more - details and examples of filter expressions, run $ gcloud topic filters. - This flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --limit=LIMIT - Maximum number of resources to list. The default is unlimited. This - flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --page-size=PAGE_SIZE - Some services group resource list output into pages. This flag - specifies the maximum number of resources per page. The default is - determined by the service if it supports paging, otherwise it is - unlimited (no paging). Paging may be applied before or after --filter - and --limit depending on the service. - - --sort-by=[FIELD,...] - Comma-separated list of resource field key names to sort by. The - default order is ascending. Prefix a field with ``~'' for descending - order on that field. This flag interacts with other flags that are - applied in this order: --flatten, --sort-by, --filter, --limit. - - --uri - Print a list of resource URIs instead of the default output, and change - the command output to a list of URIs. If this flag is used with - --format, the formatting is applied on this URI list. To display URIs - alongside other keys instead, use the uri() transform. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the gameservices/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - These variants are also available: - - $ gcloud alpha game servers deployments list - - $ gcloud beta game servers deployments list - diff --git a/gcloud/game/servers/deployments/update b/gcloud/game/servers/deployments/update deleted file mode 100644 index 7bbf725b8..000000000 --- a/gcloud/game/servers/deployments/update +++ /dev/null @@ -1,116 +0,0 @@ -NAME - gcloud game servers deployments update - update a Deployment - -SYNOPSIS - gcloud game servers deployments update (DEPLOYMENT : --location=LOCATION) - [--async] [--description=DESCRIPTION] [--update-labels=[KEY=VALUE,...]] - [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Update a Cloud Game Server Deployment. - -EXAMPLES - To update description for Game Server Deployment 'my-deployment' in project - 'my-project', and location in 'global'(deployments only support the default - 'global' location) run: - - $ gcloud game servers deployments update my-deployment \ - --project=my-project --location=global \ - --description="New description" - - To update labels for Game Server Deployment 'my-deployment' in project - 'my-project' run: - - $ gcloud game servers deployments update my-deployment \ - --project=my-project --location=global \ - --update-labels="key1=val1" - -POSITIONAL ARGUMENTS - Deployment resource - Cloud Game Server Deployment to update. The - arguments in this group can be used to specify the attributes of this - resource. (NOTE) Some attributes are not given arguments in this group but - can be set in other ways. - - To set the project attribute: - ◆ provide the argument deployment 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. - - DEPLOYMENT - ID of the deployment or fully qualified identifier for the - deployment. - - To set the deployment attribute: - ▸ provide the argument deployment 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 location. - - To set the location attribute: - ▸ provide the argument deployment on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -FLAGS - --async - Return immediately, without waiting for the operation in progress to - complete. - - --description=DESCRIPTION - Description for the game server deployment. - - --update-labels=[KEY=VALUE,...] - List of label KEY=VALUE pairs to update. If a label exists, its value - is modified. Otherwise, a new label is created. - - Keys must start with a lowercase character and contain only hyphens - (-), underscores (_), lowercase characters, and numbers. Values must - contain only hyphens (-), underscores (_), lowercase characters, and - numbers. - - At most one of these can be specified: - - --clear-labels - Remove all labels. If --update-labels is also specified then - --clear-labels is applied first. - - For example, to remove all labels: - - $ gcloud game servers deployments update --clear-labels - - To remove all existing labels and create two new labels, foo and baz: - - $ gcloud game servers deployments update --clear-labels \ - --update-labels foo=bar,baz=qux - - --remove-labels=[KEY,...] - List of label keys to remove. If a label does not exist it is - silently ignored. If --update-labels is also specified then - --update-labels is applied first. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the gameservices/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - These variants are also available: - - $ gcloud alpha game servers deployments update - - $ gcloud beta game servers deployments update - diff --git a/gcloud/game/servers/deployments/update-rollout b/gcloud/game/servers/deployments/update-rollout deleted file mode 100644 index 8bca3db63..000000000 --- a/gcloud/game/servers/deployments/update-rollout +++ /dev/null @@ -1,138 +0,0 @@ -NAME - gcloud game servers deployments update-rollout - update a Deployment - Rollout - -SYNOPSIS - gcloud game servers deployments update-rollout - (DEPLOYMENT : --location=LOCATION) --dry-run - [--preview-time=PREVIEW_TIME] - [--clear-config-overrides - | --config-overrides-file=CONFIG_OVERRIDES_FILE] - [--clear-default-config | --default-config=DEFAULT_CONFIG] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Update a Cloud Game Server Deployment Rollout. - -EXAMPLES - To update a rollout target with new default game server config: - - $ gcloud game servers deployments update-rollout \ - example-deployment --default-config=version1 --no-dry-run - - To set a rollout target gradually by setting overrides in a YAML file using - the --config-overrides-file flag: - - $ gcloud game servers deployments update-rollout \ - example-deployment \ - --config-overrides-file=gs-cfg-overrides.yaml --no-dry-run - - Contents of gs-cfg-overrides.yaml: - - - realmsSelector: - realms: - - projects/test-project-1/locations/us-west1/realms/realm-1 - - projects/test-project-1/locations/us-west1/realms/realm-2 - configVersion: version2 - - realmsSelector: - realms: - - projects/test-project-1/locations/us-west1/realms/realm-3 - configVersion: version3 - -POSITIONAL ARGUMENTS - Deployment resource - Cloud Game Server Deployment Resource to update. The - arguments in this group can be used to specify the attributes of this - 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 deployment 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. - - DEPLOYMENT - ID of the deployment or fully qualified identifier for the - deployment. - - To set the deployment attribute: - ▸ provide the argument deployment 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 location. - - To set the location attribute: - ▸ provide the argument deployment on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -REQUIRED FLAGS - --dry-run - Validate the rollout changes, but do not execute it. - -OPTIONAL FLAGS - --preview-time=PREVIEW_TIME - This attribute is only relevant for preview (--dry-run). It is used to - validate the state for a future time. - - At most one of these can be specified: - - --clear-config-overrides - Clear the config overrides. - - --config-overrides-file=CONFIG_OVERRIDES_FILE - JSON/YAML file that specifies the Game Server config overrides. This - file can be used to gradually rollout a new config version. The - following sample file indicates that the version2 config is rolled - out to realm-1 and realm-2 while the version3 config is deployed to - realm-3. The rest of the realms are deployed with the default config - version (if one is specified). Contents of a sample yaml file: - - - realmsSelector: - realms: - - projects/test-project-1/locations/us-west1/realms/realm-1 - - projects/test-project-1/locations/us-west1/realms/realm-2 - configVersion: version2 - - realmsSelector: - realms: - - projects/test-project-1/locations/us-west1/realms/realm-3 - configVersion: version3 - - At most one of these can be specified: - - --clear-default-config - Clear the default config. - - --default-config=DEFAULT_CONFIG - Game Server config to be deployed to all clusters. The value of this - field must match an existing game server config that is a - sub-resource to the given game server deployment. If not specified, - there won't be a default config which means only the clusters - specified in the config overrides will have configs applied. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 gameservices/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - These variants are also available: - - $ gcloud alpha game servers deployments update-rollout - - $ gcloud beta game servers deployments update-rollout - diff --git a/gcloud/game/servers/help b/gcloud/game/servers/help deleted file mode 100644 index e3646011b..000000000 --- a/gcloud/game/servers/help +++ /dev/null @@ -1,36 +0,0 @@ -NAME - gcloud game servers - managed Cloud Game Servers - -SYNOPSIS - gcloud game servers GROUP [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Managed Cloud Game Servers. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -GROUPS - GROUP is one of the following: - - clusters - Deploy and manage Cloud Game Server Clusters. - - configs - Deploy and manage Cloud Game Server Configs. - - deployments - Deploy and manage Cloud Game Server Deployments. - - realms - Deploy and manage Cloud Game Server Realms. - -NOTES - These variants are also available: - - $ gcloud alpha game servers - - $ gcloud beta game servers - diff --git a/gcloud/game/servers/realms/create b/gcloud/game/servers/realms/create deleted file mode 100644 index 3b8989c49..000000000 --- a/gcloud/game/servers/realms/create +++ /dev/null @@ -1,91 +0,0 @@ -NAME - gcloud game servers realms create - create a Realm - -SYNOPSIS - gcloud game servers realms create (REALM : --location=LOCATION) - --time-zone=TIME_ZONE [--async] [--description=DESCRIPTION] - [--labels=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Create a Cloud Game Server Realm. - -EXAMPLES - To create Realm 'my-realm' in project 'my-project' with location in - 'my-location' and time zone 'UTC', run: - - $ gcloud game servers realms create my-realm --project=my-project \ - --location=my-location --time-zone=UTC --labels=a=x,b=y - -POSITIONAL ARGUMENTS - Realm resource - Cloud Game Server Realm 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 realm 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. - - REALM - ID of the realm or fully qualified identifier for the realm. - - To set the realm attribute: - ▸ provide the argument realm 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 location. - - To set the location attribute: - ▸ provide the argument realm on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -REQUIRED FLAGS - --time-zone=TIME_ZONE - Time zone where all realm-specific policies are evaluated. The value of - this field must be from the IANA time zone database: - https://www.iana.org/time-zones. - -OPTIONAL FLAGS - --async - Return immediately, without waiting for the operation in progress to - complete. - - --description=DESCRIPTION - Game server realm description. - - --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 gameservices/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - These variants are also available: - - $ gcloud alpha game servers realms create - - $ gcloud beta game servers realms create - diff --git a/gcloud/game/servers/realms/delete b/gcloud/game/servers/realms/delete deleted file mode 100644 index 8e369f09c..000000000 --- a/gcloud/game/servers/realms/delete +++ /dev/null @@ -1,73 +0,0 @@ -NAME - gcloud game servers realms delete - delete a Realm - -SYNOPSIS - gcloud game servers realms delete (REALM : --location=LOCATION) [--async] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Delete a Cloud Game Server Realm. - -EXAMPLES - To delete Realm 'my-realm' in project 'my-project' and location - 'my-location', run: - - $ gcloud game servers realms delete my-realm --project=my-project \ - --location=my-location - -POSITIONAL ARGUMENTS - Realm resource - Cloud Game Server Realm 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 realm 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. - - REALM - ID of the realm or fully qualified identifier for the realm. - - To set the realm attribute: - ▸ provide the argument realm 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 location. - - To set the location attribute: - ▸ provide the argument realm on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -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 gameservices/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - These variants are also available: - - $ gcloud alpha game servers realms delete - - $ gcloud beta game servers realms delete - diff --git a/gcloud/game/servers/realms/describe b/gcloud/game/servers/realms/describe deleted file mode 100644 index 966659b2f..000000000 --- a/gcloud/game/servers/realms/describe +++ /dev/null @@ -1,68 +0,0 @@ -NAME - gcloud game servers realms describe - describe a Realm - -SYNOPSIS - gcloud game servers realms describe (REALM : --location=LOCATION) - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Describe a Cloud Game Server Realm. - -EXAMPLES - To describe Realm 'my-realm' in project 'my-project' and location - 'my-location', run: - - $ gcloud game servers realms describe my-realm \ - --project=my-project --location=my-location - -POSITIONAL ARGUMENTS - Realm resource - Cloud Game Server Realm 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 realm 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. - - REALM - ID of the realm or fully qualified identifier for the realm. - - To set the realm attribute: - ▸ provide the argument realm 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 location. - - To set the location attribute: - ▸ provide the argument realm on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the gameservices/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - These variants are also available: - - $ gcloud alpha game servers realms describe - - $ gcloud beta game servers realms describe - diff --git a/gcloud/game/servers/realms/help b/gcloud/game/servers/realms/help deleted file mode 100644 index 9a8bda9a4..000000000 --- a/gcloud/game/servers/realms/help +++ /dev/null @@ -1,39 +0,0 @@ -NAME - gcloud game servers realms - deploy and manage Cloud Game Server Realms - -SYNOPSIS - gcloud game servers realms COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Deploy and manage Cloud Game Server Realms. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -COMMANDS - COMMAND is one of the following: - - create - Create a Realm. - - delete - Delete a Realm. - - describe - Describe a Realm. - - list - List Realms. - - update - Update a Realm. - -NOTES - These variants are also available: - - $ gcloud alpha game servers realms - - $ gcloud beta game servers realms - diff --git a/gcloud/game/servers/realms/list b/gcloud/game/servers/realms/list deleted file mode 100644 index 2b83ca98b..000000000 --- a/gcloud/game/servers/realms/list +++ /dev/null @@ -1,88 +0,0 @@ -NAME - gcloud game servers realms list - list Realms - -SYNOPSIS - gcloud game servers realms list [--location=LOCATION] [--filter=EXPRESSION] - [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - List Cloud Game Server Realms. - -EXAMPLES - To see the list of all Realms in project 'my-project' and location - 'my-location', run: - - $ gcloud game servers realms list --project=my-project \ - --location=my-location - -FLAGS - Location resource - Cloud Game Servers Location of the Realms to list. - 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 game_services/location 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; - ▸ set the property game_services/location. - -LIST COMMAND FLAGS - --filter=EXPRESSION - Apply a Boolean filter EXPRESSION to each resource item to be listed. - If the expression evaluates True, then that item is listed. For more - details and examples of filter expressions, run $ gcloud topic filters. - This flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --limit=LIMIT - Maximum number of resources to list. The default is unlimited. This - flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --page-size=PAGE_SIZE - Some services group resource list output into pages. This flag - specifies the maximum number of resources per page. The default is - determined by the service if it supports paging, otherwise it is - unlimited (no paging). Paging may be applied before or after --filter - and --limit depending on the service. - - --sort-by=[FIELD,...] - Comma-separated list of resource field key names to sort by. The - default order is ascending. Prefix a field with ``~'' for descending - order on that field. This flag interacts with other flags that are - applied in this order: --flatten, --sort-by, --filter, --limit. - - --uri - Print a list of resource URIs instead of the default output, and change - the command output to a list of URIs. If this flag is used with - --format, the formatting is applied on this URI list. To display URIs - alongside other keys instead, use the uri() transform. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the gameservices/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - These variants are also available: - - $ gcloud alpha game servers realms list - - $ gcloud beta game servers realms list - diff --git a/gcloud/game/servers/realms/update b/gcloud/game/servers/realms/update deleted file mode 100644 index 2fd810033..000000000 --- a/gcloud/game/servers/realms/update +++ /dev/null @@ -1,128 +0,0 @@ -NAME - gcloud game servers realms update - update a Realm - -SYNOPSIS - gcloud game servers realms update (REALM : --location=LOCATION) --dry-run - [--description=DESCRIPTION] [--preview-time=PREVIEW_TIME] - [--time-zone=TIME_ZONE] [--update-labels=[KEY=VALUE,...]] - [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Update a Cloud Game Server Realm. - -EXAMPLES - To update Realm 'my-realm' in project 'my-project' and location in - 'my-location' with a new time-zone run: - - $ gcloud game servers realms update my-realm --project=my-project \ - --location=my-location --time-zone=EST --no-dry-run - - To preview Realm update for 'my-realm' in project 'my-project' and location - in 'my-location' with a new time-zone run: - - $ gcloud game servers realms update my-realm --project=my-project \ - --location=my-location --time-zone=EST --dry-run - - To update labels for Realm 'my-realm' in project 'my-project' and location - in 'my-location' run: - - $ gcloud game servers realms update my-realm --project=my-project \ - --location=my-location --update-labels="key1=val1" --no-dry-run - -POSITIONAL ARGUMENTS - Realm resource - Cloud Game Server Realm to update. The arguments in this - group can be used to specify the attributes of this resource. (NOTE) Some - attributes are not given arguments in this group but can be set in other - ways. - - To set the project attribute: - ◆ provide the argument realm 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. - - REALM - ID of the realm or fully qualified identifier for the realm. - - To set the realm attribute: - ▸ provide the argument realm 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 location. - - To set the location attribute: - ▸ provide the argument realm on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ set the property game_services/location. - -REQUIRED FLAGS - --dry-run - Validate the changes, but do not execute it. - -OPTIONAL FLAGS - --description=DESCRIPTION - Description for the realm. - - --preview-time=PREVIEW_TIME - This attribute is only relevant for preview (--dry-run). It is used to - validate the state for a future time. - - --time-zone=TIME_ZONE - Time zone where all realm-specific policies are evaluated. The value of - this field must be from the IANA time zone database: - https://www.iana.org/time-zones. - - --update-labels=[KEY=VALUE,...] - List of label KEY=VALUE pairs to update. If a label exists, its value - is modified. Otherwise, a new label is created. - - Keys must start with a lowercase character and contain only hyphens - (-), underscores (_), lowercase characters, and numbers. Values must - contain only hyphens (-), underscores (_), lowercase characters, and - numbers. - - At most one of these can be specified: - - --clear-labels - Remove all labels. If --update-labels is also specified then - --clear-labels is applied first. - - For example, to remove all labels: - - $ gcloud game servers realms update --clear-labels - - To remove all existing labels and create two new labels, foo and baz: - - $ gcloud game servers realms update --clear-labels \ - --update-labels foo=bar,baz=qux - - --remove-labels=[KEY,...] - List of label keys to remove. If a label does not exist it is - silently ignored. If --update-labels is also specified then - --update-labels is applied first. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the gameservices/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/solutions/gaming/ - -NOTES - These variants are also available: - - $ gcloud alpha game servers realms update - - $ gcloud beta game servers realms update - diff --git a/gcloud/infra-manager/deployments/apply b/gcloud/infra-manager/deployments/apply index c81c8324f..012e54477 100644 --- a/gcloud/infra-manager/deployments/apply +++ b/gcloud/infra-manager/deployments/apply @@ -73,7 +73,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument DEPLOYMENT on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property blueprints/location. + ▸ set the property infra-manager/location. FLAGS --artifacts-gcs-bucket=ARTIFACTS_GCS_BUCKET diff --git a/gcloud/infra-manager/deployments/export-lock b/gcloud/infra-manager/deployments/export-lock index 56aa92dd2..2b522a35a 100644 --- a/gcloud/infra-manager/deployments/export-lock +++ b/gcloud/infra-manager/deployments/export-lock @@ -47,7 +47,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument DEPLOYMENT on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property blueprints/location. + ▸ set the property infra-manager/location. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/infra-manager/deployments/export-statefile b/gcloud/infra-manager/deployments/export-statefile index d376b3c5e..ec3a1de5f 100644 --- a/gcloud/infra-manager/deployments/export-statefile +++ b/gcloud/infra-manager/deployments/export-statefile @@ -46,7 +46,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument DEPLOYMENT on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property blueprints/location. + ▸ set the property infra-manager/location. FLAGS --draft diff --git a/gcloud/infra-manager/deployments/import-statefile b/gcloud/infra-manager/deployments/import-statefile index 69c3e1b22..ac47800db 100644 --- a/gcloud/infra-manager/deployments/import-statefile +++ b/gcloud/infra-manager/deployments/import-statefile @@ -48,7 +48,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument DEPLOYMENT on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property blueprints/location. + ▸ set the property infra-manager/location. REQUIRED FLAGS --lock-id=LOCK_ID diff --git a/gcloud/infra-manager/deployments/lock b/gcloud/infra-manager/deployments/lock index c80546099..7cbfb68bb 100644 --- a/gcloud/infra-manager/deployments/lock +++ b/gcloud/infra-manager/deployments/lock @@ -45,7 +45,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument DEPLOYMENT on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property blueprints/location. + ▸ set the property infra-manager/location. FLAGS --async diff --git a/gcloud/infra-manager/deployments/unlock b/gcloud/infra-manager/deployments/unlock index 079ad09e6..1a22311d3 100644 --- a/gcloud/infra-manager/deployments/unlock +++ b/gcloud/infra-manager/deployments/unlock @@ -47,7 +47,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument DEPLOYMENT on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property blueprints/location. + ▸ set the property infra-manager/location. REQUIRED FLAGS --lock-id=LOCK_ID diff --git a/gcloud/infra-manager/revisions/export-statefile b/gcloud/infra-manager/revisions/export-statefile index ad68668c8..5b8eca764 100644 --- a/gcloud/infra-manager/revisions/export-statefile +++ b/gcloud/infra-manager/revisions/export-statefile @@ -55,7 +55,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument REVISION on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property blueprints/location. + ▸ set the property infra-manager/location. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/notebooks/instances/help b/gcloud/notebooks/instances/help index e02323ba1..e92a623f3 100644 --- a/gcloud/notebooks/instances/help +++ b/gcloud/notebooks/instances/help @@ -42,6 +42,9 @@ COMMANDS list Request for listing instances. + migrate + Request for migrating instances. + register Request for registering instances. diff --git a/gcloud/notebooks/instances/migrate b/gcloud/notebooks/instances/migrate new file mode 100644 index 000000000..65b3010f7 --- /dev/null +++ b/gcloud/notebooks/instances/migrate @@ -0,0 +1,79 @@ +NAME + gcloud notebooks instances migrate - request for migrating instances + +SYNOPSIS + gcloud notebooks instances migrate (INSTANCE : --location=LOCATION) + [--async] + [--post-startup-script-option=POST_STARTUP_SCRIPT_OPTION; + default="POST_STARTUP_SCRIPT_OPTION_UNSPECIFIED"] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Request for migrating notebook instances. + +EXAMPLES + To migrate an instance, run: + + $ gcloud notebooks instances migrate example-instance \ + --location=us-central1 + + To migrate an instance and reuse the post-startup script, run: + + $ gcloud notebooks instances migrate example-instance \ + --location=us-central1 \ + --post-startup-script-option=POST_STARTUP_SCRIPT_OPTION_RERUN + +POSITIONAL ARGUMENTS + Instance resource - User-defined unique name of this instance. The + instance name must be 1 to 63 characters long and contain only lowercase + letters, numeric characters, and dashes. The first character must be a + lowercase letter and the last character cannot be a dash. 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 instance 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. + + INSTANCE + ID of the instance or fully qualified identifier for the instance. + + To set the instance attribute: + ▸ provide the argument instance 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 location of this environment + https://cloud.google.com/compute/docs/regions-zones/#locations. + + To set the location attribute: + ▸ provide the argument instance on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property notebooks/location. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --post-startup-script-option=POST_STARTUP_SCRIPT_OPTION; default="POST_STARTUP_SCRIPT_OPTION_UNSPECIFIED" + // Specifies the behavior of post startup script during migration. + POST_STARTUP_SCRIPT_OPTION must be one of: + POST_STARTUP_SCRIPT_OPTION_UNSPECIFIED, + POST_STARTUP_SCRIPT_OPTION_SKIP, POST_STARTUP_SCRIPT_OPTION_RERUN. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. diff --git a/gcloud/run/deploy b/gcloud/run/deploy index 34fbf66dd..3442d1cea 100644 --- a/gcloud/run/deploy +++ b/gcloud/run/deploy @@ -31,6 +31,10 @@ SYNOPSIS | --clear-cloudsql-instances | --remove-cloudsql-instances=[CLOUDSQL-INSTANCES,...] | --set-cloudsql-instances=[CLOUDSQL-INSTANCES,...] + --add-custom-audiences=[CUSTOM-AUDIENCES,...] + | --clear-custom-audiences + | --remove-custom-audiences=[CUSTOM-AUDIENCES,...] + | --set-custom-audiences=[CUSTOM-AUDIENCES,...] --binary-authorization=POLICY | --clear-binary-authorization --clear-encryption-key-shutdown-hours | --encryption-key-shutdown-hours=ENCRYPTION_KEY_SHUTDOWN_HOURS @@ -462,6 +466,24 @@ FLAGS Completely replace the current Cloud SQL instances with the given values. + These flags modify the custom audiences that can be used in the audience + field of ID token for authenticated requests. + + At most one of these can be specified: + + --add-custom-audiences=[CUSTOM-AUDIENCES,...] + Append the given values to the current custom audiences. + + --clear-custom-audiences + Empty the current custom audiences. + + --remove-custom-audiences=[CUSTOM-AUDIENCES,...] + Remove the given values from the current custom audiences. + + --set-custom-audiences=[CUSTOM-AUDIENCES,...] + Completely replace the current custom audiences with the given + values. + At most one of these can be specified: --binary-authorization=POLICY diff --git a/gcloud/run/jobs/execute b/gcloud/run/jobs/execute index 8580fa95e..2f0a822aa 100644 --- a/gcloud/run/jobs/execute +++ b/gcloud/run/jobs/execute @@ -2,7 +2,9 @@ NAME gcloud run jobs execute - execute a job SYNOPSIS - gcloud run jobs execute [JOB] [--region=REGION] [--async | --wait] + gcloud run jobs execute [JOB] [--args=[ARG,...]] [--region=REGION] + [--task-timeout=TASK_TIMEOUT] [--tasks=TASKS] + [--update-env-vars=[KEY=VALUE,...]] [--async | --wait] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -34,10 +36,37 @@ POSITIONAL ARGUMENTS ▸ specify the job name from an interactive prompt. FLAGS + --args=[ARG,...] + Comma-separated arguments passed to the command run by the container + image. If provided, an execution will be created with the input values. + Otherwise, the existing arguments of the job are used. + --region=REGION Region in which the resource can be found. Alternatively, set the property [run/region]. + --task-timeout=TASK_TIMEOUT + The existing maximum time (deadline) a job task attempt can run for. If + provided, an execution will be created with this value. Otherwise + existing maximum time of the job is used. In the case of retries, this + deadline applies to each attempt of a task. If the task attempt does + not complete within this time, it will be killed. It is specified as a + duration; for example, "10m5s" is ten minutes, and five seconds. If you + don't specify a unit, seconds is assumed. For example, "10" is 10 + seconds. + + --tasks=TASKS + Number of tasks that must run to completion for the execution to be + considered done. If provided, an execution will be created with this + value. Otherwise the existing task count of the job is used. + + --update-env-vars=[KEY=VALUE,...] + List of key-value pairs to set as environment variables overrides for + an execution of a job. If provided, an execution will be created with + the merge result of the input values and the existing environment + variables. New value overrides existing value if they have the same + key. If not provided, existing environment variables are used. + At most one of these can be specified: --async diff --git a/gcloud/run/services/update b/gcloud/run/services/update index 82cb1ea76..5e39e0ea2 100644 --- a/gcloud/run/services/update +++ b/gcloud/run/services/update @@ -19,6 +19,10 @@ SYNOPSIS | --clear-cloudsql-instances | --remove-cloudsql-instances=[CLOUDSQL-INSTANCES,...] | --set-cloudsql-instances=[CLOUDSQL-INSTANCES,...] + --add-custom-audiences=[CUSTOM-AUDIENCES,...] + | --clear-custom-audiences + | --remove-custom-audiences=[CUSTOM-AUDIENCES,...] + | --set-custom-audiences=[CUSTOM-AUDIENCES,...] --binary-authorization=POLICY | --clear-binary-authorization --clear-encryption-key-shutdown-hours | --encryption-key-shutdown-hours=ENCRYPTION_KEY_SHUTDOWN_HOURS @@ -291,6 +295,24 @@ FLAGS Completely replace the current Cloud SQL instances with the given values. + These flags modify the custom audiences that can be used in the audience + field of ID token for authenticated requests. + + At most one of these can be specified: + + --add-custom-audiences=[CUSTOM-AUDIENCES,...] + Append the given values to the current custom audiences. + + --clear-custom-audiences + Empty the current custom audiences. + + --remove-custom-audiences=[CUSTOM-AUDIENCES,...] + Remove the given values from the current custom audiences. + + --set-custom-audiences=[CUSTOM-AUDIENCES,...] + Completely replace the current custom audiences with the given + values. + At most one of these can be specified: --binary-authorization=POLICY diff --git a/gcloud/services/vpc-peerings/enable-vpc-service-controls b/gcloud/services/vpc-peerings/enable-vpc-service-controls index 16b8cdc6d..89ee3ba5f 100644 --- a/gcloud/services/vpc-peerings/enable-vpc-service-controls +++ b/gcloud/services/vpc-peerings/enable-vpc-service-controls @@ -9,14 +9,35 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - This command enables VPC Service Controls for the peering connection. + This command configures IPv4 routes and DNS zones applicable to a service + producer VPC network (for example, servicenetworking). The route and DNS + configuration match those recommended for using the + restricted.googleapis.com VIP: - The local default route (destination 0.0.0.0/0, next hop default internet - gateway) is deleted in the service producer VPC network. After deletion, - the service producer VPC network can import a custom default route from the - peering connection to the customer VPC network. This requires that the - customer VPC network be configured to export custom routes. The custom - default route cannot have an associated network tag. + When enabled, Google Cloud makes the following route configuration changes + in the service producer VPC network: Google Cloud removes the IPv4 default + route (destination 0.0.0.0/0, next hop default internet gateway). Google + Cloud then creates an IPv4 route for destination 199.36.153.4/30 using the + default internet gateway next hop. + + When enabled, Google Cloud also creates Cloud DNS managed private zones and + authorizes those zones for the service producer VPC network. The zones + include googleapis.com, pkg.dev, gcr.io, and other necessary domains or + host names for Google APIs and services that are compatible with VPC + Service Controls. Record data in the zones resolves all host names to + 199.36.153.4, 199.36.153.5, 199.36.153.6, and 199.36.153.7. + + When disabled, Google Cloud makes the following route configuration changes + in the service producer VPC network: Google Cloud restores a default route + (destination 0.0.0.0/0, next hop default internet gateway). Google Cloud + also deletes the Cloud DNS managed private zones that provided the host + name overrides. + + While enabled, the service producer VPC network can still import static and + dynamic routes from the peered customer network if you enable custom route + export. These custom routes can include a default route. For this reason, + this command is not to be used solely as a means for preventing access to + the internet. EXAMPLES To enable VPC Service Controls for a connection peering a network called diff --git a/gcloud/storage/buckets/create b/gcloud/storage/buckets/create index 8b3f1d152..7bcc7a4b2 100644 --- a/gcloud/storage/buckets/create +++ b/gcloud/storage/buckets/create @@ -13,8 +13,9 @@ SYNOPSIS [--placement=REGION,REGION] [--recovery-point-objective=SETTING, --rpo=SETTING] [--retention-period=RETENTION_PERIOD] - [--[no-]uniform-bucket-level-access, -b] [--[no-]enable-autoclass] - [GCLOUD_WIDE_FLAG ...] + [--[no-]uniform-bucket-level-access, -b] + [--autoclass-terminal-storage-class=AUTOCLASS_TERMINAL_STORAGE_CLASS + --[no-]enable-autoclass] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Create new buckets. @@ -99,6 +100,11 @@ FLAGS --no-uniform-bucket-level-access to disable. AUTOCLASS FLAGS + --autoclass-terminal-storage-class=AUTOCLASS_TERMINAL_STORAGE_CLASS + The storage class that objects in the bucket eventually transition to + if they are not read for a certain length of time. Only valid if + Autoclass is enabled. + --[no-]enable-autoclass The Autoclass feature automatically selects the best storage class for objects based on access patterns. Use --enable-autoclass to enable and diff --git a/gcloud/storage/buckets/update b/gcloud/storage/buckets/update index 0851e169c..5cc2428ee 100644 --- a/gcloud/storage/buckets/update +++ b/gcloud/storage/buckets/update @@ -4,7 +4,9 @@ NAME SYNOPSIS gcloud storage buckets update URL [URL ...] [--additional-headers=HEADER=VALUE] [--continue-on-error, -c] - [--[no-]default-event-based-hold] [--lock-retention-period] + [--[no-]default-event-based-hold] + [--default-storage-class=DEFAULT_STORAGE_CLASS] + [--lock-retention-period] [--recovery-point-objective=SETTING, --rpo=SETTING] [--[no-]requester-pays] [--[no-]uniform-bucket-level-access] [--[no-]versioning] @@ -30,7 +32,8 @@ SYNOPSIS [--clear-web-error-page | --web-error-page=WEB_ERROR_PAGE] [--clear-web-main-page-suffix | --web-main-page-suffix=WEB_MAIN_PAGE_SUFFIX] - [--[no-]enable-autoclass] [GCLOUD_WIDE_FLAG ...] + [--autoclass-terminal-storage-class=AUTOCLASS_TERMINAL_STORAGE_CLASS + --[no-]enable-autoclass] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Update the settings for a bucket. @@ -77,6 +80,9 @@ FLAGS retroactively). Use --default-event-based-hold to enable and --no-default-event-based-hold to disable. + --default-storage-class=DEFAULT_STORAGE_CLASS + Sets the default storage class for the bucket. + --lock-retention-period Locks an unlocked retention policy on the buckets. Caution: A locked retention policy cannot be removed from a bucket or reduced in @@ -294,6 +300,11 @@ FLAGS usual bucket listing. AUTOCLASS FLAGS + --autoclass-terminal-storage-class=AUTOCLASS_TERMINAL_STORAGE_CLASS + The storage class that objects in the bucket eventually transition to + if they are not read for a certain length of time. Only valid if + Autoclass is enabled. + --[no-]enable-autoclass The Autoclass feature automatically selects the best storage class for objects based on access patterns. Use --enable-autoclass to enable and diff --git a/gcloud/storage/cp b/gcloud/storage/cp index 68ab8f200..db735ee81 100644 --- a/gcloud/storage/cp +++ b/gcloud/storage/cp @@ -273,11 +273,10 @@ ENCRYPTION FLAGS encryption key can be a customer-supplied encryption key (An RFC 4648 section 4 base64-encoded AES256 string), or a customer-managed encryption key of the form - projects/{project}/locations/{location}/keyRings/ - {key-ring}/cryptoKeys/{crypto-key}. The specified key also acts as a - decryption key, which is useful when copying or moving encryted data to - a new location. Using this flag in an objects update command triggers a - rewrite of target objects. + projects/{project}/locations/{location}/keyRings/{key-ring}/cryptoKeys/{crypto-key}. + The specified key also acts as a decryption key, which is useful when + copying or moving encrypted data to a new location. Using this flag in + an objects update command triggers a rewrite of target objects. OBJECT METADATA FLAGS --cache-control=CACHE_CONTROL diff --git a/gcloud/storage/hash b/gcloud/storage/hash index 28c37892c..5725a5cc8 100644 --- a/gcloud/storage/hash +++ b/gcloud/storage/hash @@ -25,7 +25,7 @@ EXAMPLES To get just the MD5 hash digest of a local object in hex format: - $ gcloud storage hash /dir/object.txt --skip-md5 --hex + $ gcloud storage hash /dir/object.txt --skip-crc32c --hex POSITIONAL ARGUMENTS URLS [URLS ...] diff --git a/gcloud/storage/mv b/gcloud/storage/mv index 9fcdcc6ed..1984a7b73 100644 --- a/gcloud/storage/mv +++ b/gcloud/storage/mv @@ -278,11 +278,10 @@ ENCRYPTION FLAGS encryption key can be a customer-supplied encryption key (An RFC 4648 section 4 base64-encoded AES256 string), or a customer-managed encryption key of the form - projects/{project}/locations/{location}/keyRings/ - {key-ring}/cryptoKeys/{crypto-key}. The specified key also acts as a - decryption key, which is useful when copying or moving encryted data to - a new location. Using this flag in an objects update command triggers a - rewrite of target objects. + projects/{project}/locations/{location}/keyRings/{key-ring}/cryptoKeys/{crypto-key}. + The specified key also acts as a decryption key, which is useful when + copying or moving encrypted data to a new location. Using this flag in + an objects update command triggers a rewrite of target objects. OBJECT METADATA FLAGS --cache-control=CACHE_CONTROL diff --git a/gcloud/storage/objects/update b/gcloud/storage/objects/update index e123ed1f1..67a0e2d94 100644 --- a/gcloud/storage/objects/update +++ b/gcloud/storage/objects/update @@ -139,11 +139,10 @@ ENCRYPTION FLAGS encryption key can be a customer-supplied encryption key (An RFC 4648 section 4 base64-encoded AES256 string), or a customer-managed encryption key of the form - projects/{project}/locations/{location}/keyRings/ - {key-ring}/cryptoKeys/{crypto-key}. The specified key also acts as a - decryption key, which is useful when copying or moving encryted data to - a new location. Using this flag in an objects update command triggers a - rewrite of target objects. + projects/{project}/locations/{location}/keyRings/{key-ring}/cryptoKeys/{crypto-key}. + The specified key also acts as a decryption key, which is useful when + copying or moving encrypted data to a new location. Using this flag in + an objects update command triggers a rewrite of target objects. OBJECT METADATA FLAGS --cache-control=CACHE_CONTROL diff --git a/gcloud/storage/operations/list b/gcloud/storage/operations/list index af247829e..47abaabe1 100644 --- a/gcloud/storage/operations/list +++ b/gcloud/storage/operations/list @@ -2,7 +2,7 @@ NAME gcloud storage operations list - list storage operations SYNOPSIS - gcloud storage operations list OPERATION_NAME + gcloud storage operations list PARENT_RESOURCE_NAME [--server-filter=SERVER_FILTER] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] @@ -25,14 +25,17 @@ EXAMPLES $ gcloud storage operations list gs://my-bucket POSITIONAL ARGUMENTS - OPERATION_NAME - The operation name including the Cloud Storage bucket and operation ID. + PARENT_RESOURCE_NAME + The operation parent resource in the format + "projects/_/buckets/BUCKET". FLAGS --server-filter=SERVER_FILTER Server-side filter string used to determine what operations to return. - Example: (done = true AND complete_time >= "2023-01-01T00:00:00Z") OR - requested_cancellation = true + Example: '(done = true AND complete_time >= "2023-01-01T00:00:00Z") OR + requested_cancellation = true' Note that the entire filter string must + be in quotes and date strings within the filter must be in embedded + quotes. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/storage/rsync b/gcloud/storage/rsync index b7a82bb11..9eece2d3e 100644 --- a/gcloud/storage/rsync +++ b/gcloud/storage/rsync @@ -213,11 +213,10 @@ ENCRYPTION FLAGS encryption key can be a customer-supplied encryption key (An RFC 4648 section 4 base64-encoded AES256 string), or a customer-managed encryption key of the form - projects/{project}/locations/{location}/keyRings/ - {key-ring}/cryptoKeys/{crypto-key}. The specified key also acts as a - decryption key, which is useful when copying or moving encryted data to - a new location. Using this flag in an objects update command triggers a - rewrite of target objects. + projects/{project}/locations/{location}/keyRings/{key-ring}/cryptoKeys/{crypto-key}. + The specified key also acts as a decryption key, which is useful when + copying or moving encrypted data to a new location. Using this flag in + an objects update command triggers a rewrite of target objects. OBJECT METADATA FLAGS --cache-control=CACHE_CONTROL diff --git a/gcloud/tasks/cmek-config/describe b/gcloud/tasks/cmek-config/describe new file mode 100644 index 000000000..878536096 --- /dev/null +++ b/gcloud/tasks/cmek-config/describe @@ -0,0 +1,35 @@ +NAME + gcloud tasks cmek-config describe - get CMEK configuration for Cloud Tasks + in the specified location + +SYNOPSIS + gcloud tasks cmek-config describe --location=LOCATION + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Get CMEK configuration for Cloud Tasks in the specified location. + +EXAMPLES + To get a CMEK config: + + $ gcloud tasks cmek-config describe --location=my-location + +REQUIRED FLAGS + --location=LOCATION + Google Cloud location for the KMS key. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --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 tasks cmek-config describe + + $ gcloud beta tasks cmek-config describe + diff --git a/gcloud/tasks/cmek-config/help b/gcloud/tasks/cmek-config/help new file mode 100644 index 000000000..4d691fbd5 --- /dev/null +++ b/gcloud/tasks/cmek-config/help @@ -0,0 +1,31 @@ +NAME + gcloud tasks cmek-config - get or change CMEK configuration for Cloud Tasks + +SYNOPSIS + gcloud tasks cmek-config COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Get or change CMEK configuration for Cloud Tasks. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + Get CMEK configuration for Cloud Tasks in the specified location. + + update + Enable, disable, or edit CMEK configuration for Cloud Tasks in the + specified location. + +NOTES + These variants are also available: + + $ gcloud alpha tasks cmek-config + + $ gcloud beta tasks cmek-config + diff --git a/gcloud/tasks/cmek-config/update b/gcloud/tasks/cmek-config/update new file mode 100644 index 000000000..ce9a306e9 --- /dev/null +++ b/gcloud/tasks/cmek-config/update @@ -0,0 +1,67 @@ +NAME + gcloud tasks cmek-config update - enable, disable, or edit CMEK + configuration for Cloud Tasks in the specified location + +SYNOPSIS + gcloud tasks cmek-config update [--location=LOCATION] + [--clear-kms-key | [--kms-key-name=KMS_KEY_NAME + : --kms-keyring=KMS_KEYRING --kms-project=KMS_PROJECT]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Enable, disable, or edit CMEK configuration for Cloud Tasks in the + specified location. + +EXAMPLES + To update a CMEK config: + + $ gcloud tasks cmek-config update \ + --kms-key-name=projects/my-project/locations/my-location/\ + keyRings/my-keyring/cryptoKeys/key + +FLAGS + --location=LOCATION + Google Cloud location for the KMS key. + + Flags for Clearing or Updating CMEK Resource + + At most one of these can be specified: + + Flags for clearing CMEK Resource key. + + --clear-kms-key + Disables CMEK for Cloud Tasks in the specified location by clearing + the Cloud KMS cryptokey from the Cloud Tasks project and CMEK + configuration. + + Flags for Updating CMEK Resource key + + --kms-key-name=KMS_KEY_NAME + Fully qualified identifier for the key or just the key ID. The + latter requires that the --kms-keyring and --kms-project flags be + provided too. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --kms-keyring=KMS_KEYRING + KMS keyring of the KMS key. + + --kms-project=KMS_PROJECT + Google Cloud project for the KMS key. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --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 tasks cmek-config update + + $ gcloud beta tasks cmek-config update + diff --git a/gcloud/tasks/help b/gcloud/tasks/help index 3b75d6685..c8c11d822 100644 --- a/gcloud/tasks/help +++ b/gcloud/tasks/help @@ -15,6 +15,9 @@ GCLOUD WIDE FLAGS GROUPS GROUP is one of the following: + cmek-config + Get or change CMEK configuration for Cloud Tasks. + locations Get information about Cloud Tasks locations.