From d6d01162c7e3c4548e8e63b69b0a9930a619cd64 Mon Sep 17 00:00:00 2001 From: Automated Date: Wed, 13 Aug 2025 10:57:56 +0000 Subject: [PATCH] gcloud: Wed Aug 13 10:57:55 UTC 2025 --- gcloud/_version | 8 +- gcloud/ai/endpoints/deploy-model | 8 +- .../access-context-manager/perimeters/create | 31 +- .../perimeters/dry-run/create | 48 +- .../perimeters/dry-run/update | 42 +- .../access-context-manager/perimeters/update | 51 +- gcloud/alpha/alloydb/instances/create | 4 + .../alpha/alloydb/instances/create-secondary | 64 ++- gcloud/alpha/alloydb/instances/update | 4 + gcloud/alpha/assured/workloads/list | 5 +- gcloud/alpha/backup-dr/backup-vaults/create | 17 +- gcloud/alpha/compute/advice/calendar-mode | 14 +- gcloud/alpha/compute/commitments/create | 6 +- .../firewall-policies/mirroring-rules/create | 14 +- .../compute/firewall-policies/rules/create | 12 +- .../health-checks/create/grpc-with-tls | 119 +++++ .../alpha/compute/health-checks/create/help | 4 + .../health-checks/update/grpc-with-tls | 115 +++++ .../alpha/compute/health-checks/update/help | 3 + .../compute/instance-groups/managed/create | 17 +- .../alpha/compute/instance-templates/create | 9 +- .../instance-templates/create-with-container | 9 +- gcloud/alpha/compute/instances/bulk/create | 9 +- gcloud/alpha/compute/instances/create | 9 +- .../compute/instances/create-with-container | 9 +- gcloud/alpha/compute/instances/set-scheduling | 8 +- .../configure-bandwidth-percentage-policy | 21 +- .../configure-shaper-average-percentage | 25 +- .../mirroring-rules/create | 14 +- .../network-firewall-policies/rules/create | 11 +- gcloud/alpha/compute/preview-features/update | 6 +- .../compute/public-delegated-prefixes/create | 9 +- gcloud/alpha/compute/queued-resources/create | 9 +- gcloud/alpha/container/ai/help | 4 +- gcloud/alpha/container/ai/profiles/help | 4 +- .../container/ai/profiles/manifests/create | 4 +- .../container/ai/profiles/manifests/help | 4 +- .../ai/profiles/model-server-versions/help | 4 +- .../ai/profiles/model-server-versions/list | 4 +- .../container/ai/profiles/model-servers/help | 4 +- .../container/ai/profiles/model-servers/list | 4 +- .../alpha/container/ai/profiles/models/help | 4 +- .../alpha/container/ai/profiles/models/list | 4 +- .../container/fleet/config-management/disable | 92 +++- .../container/fleet/config-management/help | 2 +- gcloud/alpha/container/fleet/packages/create | 4 +- gcloud/alpha/container/fleet/packages/delete | 4 +- .../alpha/container/fleet/packages/describe | 4 +- gcloud/alpha/container/fleet/packages/help | 4 +- gcloud/alpha/container/fleet/packages/list | 4 +- .../fleet/packages/resource-bundles/create | 4 +- .../fleet/packages/resource-bundles/delete | 4 +- .../fleet/packages/resource-bundles/describe | 4 +- .../fleet/packages/resource-bundles/help | 4 +- .../fleet/packages/resource-bundles/list | 4 +- .../packages/resource-bundles/releases/create | 4 +- .../packages/resource-bundles/releases/delete | 4 +- .../resource-bundles/releases/describe | 4 +- .../packages/resource-bundles/releases/help | 4 +- .../packages/resource-bundles/releases/list | 4 +- .../packages/resource-bundles/releases/update | 4 +- .../fleet/packages/resource-bundles/update | 4 +- .../container/fleet/packages/rollouts/abort | 4 +- .../fleet/packages/rollouts/describe | 4 +- .../container/fleet/packages/rollouts/help | 4 +- .../container/fleet/packages/rollouts/list | 4 +- .../container/fleet/packages/rollouts/resume | 4 +- .../container/fleet/packages/rollouts/suspend | 4 +- gcloud/alpha/container/fleet/packages/update | 4 +- .../container/hub/config-management/disable | 91 +++- .../container/hub/config-management/help | 2 +- gcloud/alpha/container/hub/packages/create | 4 +- gcloud/alpha/container/hub/packages/delete | 4 +- gcloud/alpha/container/hub/packages/describe | 4 +- gcloud/alpha/container/hub/packages/help | 4 +- gcloud/alpha/container/hub/packages/list | 4 +- .../hub/packages/resource-bundles/create | 4 +- .../hub/packages/resource-bundles/delete | 4 +- .../hub/packages/resource-bundles/describe | 4 +- .../hub/packages/resource-bundles/help | 4 +- .../hub/packages/resource-bundles/list | 4 +- .../packages/resource-bundles/releases/create | 4 +- .../packages/resource-bundles/releases/delete | 4 +- .../resource-bundles/releases/describe | 4 +- .../packages/resource-bundles/releases/help | 4 +- .../packages/resource-bundles/releases/list | 4 +- .../packages/resource-bundles/releases/update | 4 +- .../hub/packages/resource-bundles/update | 4 +- .../container/hub/packages/rollouts/abort | 4 +- .../container/hub/packages/rollouts/describe | 4 +- .../container/hub/packages/rollouts/help | 4 +- .../container/hub/packages/rollouts/list | 4 +- .../container/hub/packages/rollouts/resume | 4 +- .../container/hub/packages/rollouts/suspend | 4 +- gcloud/alpha/container/hub/packages/update | 4 +- .../dataplex/datascans/create/data-quality | 6 +- .../dataplex/datascans/update/data-quality | 6 +- gcloud/alpha/managed-kafka/acls/list | 11 +- gcloud/alpha/managed-kafka/clusters/update | 10 +- gcloud/alpha/ml-engine/explain | 104 ----- gcloud/alpha/ml-engine/help | 64 --- gcloud/alpha/ml-engine/jobs/cancel | 33 -- gcloud/alpha/ml-engine/jobs/describe | 59 --- gcloud/alpha/ml-engine/jobs/help | 48 -- gcloud/alpha/ml-engine/jobs/stream-logs | 51 -- gcloud/alpha/ml-engine/jobs/submit/help | 33 -- gcloud/alpha/ml-engine/jobs/submit/prediction | 144 ------ gcloud/alpha/ml-engine/jobs/submit/training | 439 ------------------ gcloud/alpha/ml-engine/jobs/update | 67 --- gcloud/alpha/ml-engine/local/help | 33 -- gcloud/alpha/ml-engine/local/predict | 91 ---- gcloud/alpha/ml-engine/local/train | 111 ----- gcloud/alpha/ml-engine/locations/describe | 59 --- gcloud/alpha/ml-engine/locations/help | 30 -- .../ml-engine/models/add-iam-policy-binding | 143 ------ gcloud/alpha/ml-engine/models/create | 89 ---- gcloud/alpha/ml-engine/models/delete | 50 -- gcloud/alpha/ml-engine/models/describe | 50 -- gcloud/alpha/ml-engine/models/get-iam-policy | 96 ---- gcloud/alpha/ml-engine/models/help | 61 --- gcloud/alpha/ml-engine/models/list | 75 --- .../models/remove-iam-policy-binding | 147 ------ gcloud/alpha/ml-engine/models/set-iam-policy | 79 ---- gcloud/alpha/ml-engine/models/update | 79 ---- gcloud/alpha/ml-engine/operations/cancel | 47 -- gcloud/alpha/ml-engine/operations/describe | 48 -- gcloud/alpha/ml-engine/operations/help | 39 -- gcloud/alpha/ml-engine/operations/list | 76 --- gcloud/alpha/ml-engine/operations/wait | 52 --- gcloud/alpha/ml-engine/predict | 109 ----- gcloud/alpha/ml-engine/versions/create | 260 ----------- gcloud/alpha/ml-engine/versions/delete | 51 -- gcloud/alpha/ml-engine/versions/describe | 51 -- gcloud/alpha/ml-engine/versions/help | 51 -- gcloud/alpha/ml-engine/versions/list | 79 ---- gcloud/alpha/ml-engine/versions/set-default | 55 --- gcloud/alpha/ml-engine/versions/update | 152 ------ gcloud/alpha/netapp/volumes/create | 4 + gcloud/alpha/netapp/volumes/update | 4 + gcloud/assured/workloads/list | 5 +- gcloud/backup-dr/backup-vaults/create | 17 +- gcloud/beta/assured/workloads/list | 5 +- gcloud/beta/compute/advice/calendar-mode | 14 +- .../firewall-policies/mirroring-rules/create | 14 +- .../compute/firewall-policies/rules/create | 13 +- .../compute/instance-groups/managed/create | 15 + gcloud/beta/compute/instance-templates/create | 9 +- .../instance-templates/create-with-container | 11 +- gcloud/beta/compute/instances/bulk/create | 9 +- gcloud/beta/compute/instances/create | 9 +- .../compute/instances/create-with-container | 9 +- gcloud/beta/compute/instances/set-scheduling | 9 +- .../configure-bandwidth-percentage-policy | 21 +- .../configure-shaper-average-percentage | 25 +- .../mirroring-rules/create | 14 +- .../network-firewall-policies/rules/create | 11 +- gcloud/beta/compute/networks/subnets/describe | 10 +- gcloud/beta/compute/networks/subnets/list | 13 +- gcloud/beta/compute/preview-features/update | 6 +- .../container/fleet/config-management/disable | 92 +++- .../container/fleet/config-management/help | 2 +- gcloud/beta/container/fleet/packages/create | 6 +- gcloud/beta/container/fleet/packages/delete | 6 +- gcloud/beta/container/fleet/packages/describe | 6 +- gcloud/beta/container/fleet/packages/help | 6 +- gcloud/beta/container/fleet/packages/list | 6 +- .../fleet/packages/resource-bundles/create | 6 +- .../fleet/packages/resource-bundles/delete | 6 +- .../fleet/packages/resource-bundles/describe | 6 +- .../fleet/packages/resource-bundles/help | 6 +- .../fleet/packages/resource-bundles/list | 6 +- .../packages/resource-bundles/releases/create | 6 +- .../packages/resource-bundles/releases/delete | 6 +- .../resource-bundles/releases/describe | 6 +- .../packages/resource-bundles/releases/help | 6 +- .../packages/resource-bundles/releases/list | 6 +- .../packages/resource-bundles/releases/update | 6 +- .../fleet/packages/resource-bundles/update | 6 +- .../container/fleet/packages/rollouts/abort | 6 +- .../fleet/packages/rollouts/describe | 6 +- .../container/fleet/packages/rollouts/help | 6 +- .../container/fleet/packages/rollouts/list | 6 +- .../container/fleet/packages/rollouts/resume | 6 +- .../container/fleet/packages/rollouts/suspend | 6 +- gcloud/beta/container/fleet/packages/update | 6 +- .../container/hub/config-management/disable | 91 +++- .../beta/container/hub/config-management/help | 2 +- gcloud/beta/container/hub/packages/create | 6 +- gcloud/beta/container/hub/packages/delete | 6 +- gcloud/beta/container/hub/packages/describe | 6 +- gcloud/beta/container/hub/packages/help | 6 +- gcloud/beta/container/hub/packages/list | 6 +- .../hub/packages/resource-bundles/create | 6 +- .../hub/packages/resource-bundles/delete | 6 +- .../hub/packages/resource-bundles/describe | 6 +- .../hub/packages/resource-bundles/help | 6 +- .../hub/packages/resource-bundles/list | 6 +- .../packages/resource-bundles/releases/create | 6 +- .../packages/resource-bundles/releases/delete | 6 +- .../resource-bundles/releases/describe | 6 +- .../packages/resource-bundles/releases/help | 6 +- .../packages/resource-bundles/releases/list | 6 +- .../packages/resource-bundles/releases/update | 6 +- .../hub/packages/resource-bundles/update | 6 +- .../container/hub/packages/rollouts/abort | 6 +- .../container/hub/packages/rollouts/describe | 6 +- .../beta/container/hub/packages/rollouts/help | 6 +- .../beta/container/hub/packages/rollouts/list | 6 +- .../container/hub/packages/rollouts/resume | 6 +- .../container/hub/packages/rollouts/suspend | 6 +- gcloud/beta/container/hub/packages/update | 6 +- gcloud/beta/dataflow/flex-template/build | 8 +- gcloud/beta/managed-kafka/acls/list | 11 +- gcloud/beta/managed-kafka/clusters/update | 10 +- gcloud/beta/ml-engine/explain | 102 ---- gcloud/beta/ml-engine/help | 59 --- gcloud/beta/ml-engine/jobs/cancel | 31 -- gcloud/beta/ml-engine/jobs/describe | 57 --- gcloud/beta/ml-engine/jobs/help | 46 -- gcloud/beta/ml-engine/jobs/stream-logs | 49 -- gcloud/beta/ml-engine/jobs/submit/help | 31 -- gcloud/beta/ml-engine/jobs/submit/prediction | 121 ----- gcloud/beta/ml-engine/jobs/submit/training | 437 ----------------- gcloud/beta/ml-engine/jobs/update | 65 --- gcloud/beta/ml-engine/local/help | 31 -- gcloud/beta/ml-engine/local/predict | 89 ---- gcloud/beta/ml-engine/local/train | 108 ----- .../ml-engine/models/add-iam-policy-binding | 89 ---- gcloud/beta/ml-engine/models/create | 87 ---- gcloud/beta/ml-engine/models/delete | 48 -- gcloud/beta/ml-engine/models/describe | 48 -- gcloud/beta/ml-engine/models/get-iam-policy | 94 ---- gcloud/beta/ml-engine/models/help | 59 --- gcloud/beta/ml-engine/models/list | 73 --- .../models/remove-iam-policy-binding | 101 ---- gcloud/beta/ml-engine/models/set-iam-policy | 77 --- gcloud/beta/ml-engine/models/update | 77 --- gcloud/beta/ml-engine/operations/cancel | 45 -- gcloud/beta/ml-engine/operations/describe | 46 -- gcloud/beta/ml-engine/operations/help | 37 -- gcloud/beta/ml-engine/operations/wait | 50 -- gcloud/beta/ml-engine/predict | 107 ----- gcloud/beta/ml-engine/versions/create | 258 ---------- gcloud/beta/ml-engine/versions/delete | 49 -- gcloud/beta/ml-engine/versions/describe | 49 -- gcloud/beta/ml-engine/versions/help | 49 -- gcloud/beta/ml-engine/versions/list | 77 --- gcloud/beta/ml-engine/versions/set-default | 53 --- gcloud/beta/ml-engine/versions/update | 150 ------ gcloud/beta/netapp/volumes/create | 4 + gcloud/beta/netapp/volumes/update | 4 + gcloud/compute/firewall-policies/rules/create | 13 +- .../mirroring-rules/create | 14 +- .../network-firewall-policies/rules/create | 11 +- gcloud/compute/routes/create | 12 +- gcloud/container/ai/help | 25 + gcloud/container/ai/profiles/benchmarks/help | 20 + .../ai/profiles/benchmarks}/list | 44 +- gcloud/container/ai/profiles/help | 51 ++ gcloud/container/ai/profiles/list | 110 +++++ gcloud/container/ai/profiles/manifests/create | 81 ++++ gcloud/container/ai/profiles/manifests/help | 27 ++ .../ai/profiles/model-server-versions/help | 27 ++ .../ai/profiles/model-server-versions}/list | 26 +- .../container/ai/profiles/model-servers/help | 26 ++ .../ai/profiles/model-servers}/list | 25 +- gcloud/container/ai/profiles/models/help | 26 ++ .../ai/profiles/models}/list | 19 +- gcloud/container/fleet/help | 3 + gcloud/container/fleet/packages/create | 44 ++ gcloud/container/fleet/packages/delete | 69 +++ gcloud/container/fleet/packages/describe | 69 +++ gcloud/container/fleet/packages/help | 48 ++ .../fleet/packages}/list | 32 +- .../fleet/packages/resource-bundles/create | 44 ++ .../fleet/packages/resource-bundles/delete | 44 ++ .../fleet/packages/resource-bundles/describe | 40 ++ .../fleet/packages/resource-bundles/help | 47 ++ .../fleet/packages/resource-bundles/list | 69 +++ .../packages/resource-bundles/releases/create | 76 +++ .../packages/resource-bundles/releases/delete | 51 ++ .../resource-bundles/releases/describe | 48 ++ .../packages/resource-bundles/releases/help | 42 ++ .../packages/resource-bundles/releases}/list | 37 +- .../packages/resource-bundles/releases/update | 51 ++ .../fleet/packages/resource-bundles/update | 44 ++ .../container/fleet/packages/rollouts/abort | 74 +++ .../fleet/packages/rollouts/describe | 48 ++ gcloud/container/fleet/packages/rollouts/help | 39 ++ gcloud/container/fleet/packages/rollouts/list | 78 ++++ .../container/fleet/packages/rollouts/resume | 74 +++ .../container/fleet/packages/rollouts/suspend | 75 +++ gcloud/container/fleet/packages/update | 69 +++ gcloud/container/help | 3 + gcloud/container/hub/help | 3 + gcloud/container/hub/packages/create | 44 ++ gcloud/container/hub/packages/delete | 69 +++ gcloud/container/hub/packages/describe | 69 +++ gcloud/container/hub/packages/help | 48 ++ gcloud/container/hub/packages/list | 67 +++ .../hub/packages/resource-bundles/create | 44 ++ .../hub/packages/resource-bundles/delete | 44 ++ .../hub/packages/resource-bundles/describe | 40 ++ .../hub/packages/resource-bundles/help | 47 ++ .../hub/packages/resource-bundles/list | 69 +++ .../packages/resource-bundles/releases/create | 75 +++ .../packages/resource-bundles/releases/delete | 50 ++ .../resource-bundles/releases/describe | 47 ++ .../packages/resource-bundles/releases/help | 42 ++ .../packages/resource-bundles/releases}/list | 40 +- .../packages/resource-bundles/releases/update | 50 ++ .../hub/packages/resource-bundles/update | 44 ++ gcloud/container/hub/packages/rollouts/abort | 74 +++ .../container/hub/packages/rollouts/describe | 47 ++ gcloud/container/hub/packages/rollouts/help | 39 ++ gcloud/container/hub/packages/rollouts/list | 78 ++++ gcloud/container/hub/packages/rollouts/resume | 74 +++ .../container/hub/packages/rollouts/suspend | 75 +++ gcloud/container/hub/packages/update | 68 +++ gcloud/dataflow/flex-template/build | 8 +- gcloud/dataplex/datascans/create/data-quality | 6 +- gcloud/dataplex/datascans/update/data-quality | 6 +- gcloud/managed-kafka/acls/list | 11 +- gcloud/managed-kafka/clusters/update | 10 +- gcloud/ml-engine/help | 55 --- gcloud/ml-engine/jobs/cancel | 30 -- gcloud/ml-engine/jobs/describe | 55 --- gcloud/ml-engine/jobs/help | 45 -- gcloud/ml-engine/jobs/stream-logs | 48 -- gcloud/ml-engine/jobs/submit/help | 30 -- gcloud/ml-engine/jobs/submit/prediction | 120 ----- gcloud/ml-engine/jobs/submit/training | 418 ----------------- gcloud/ml-engine/jobs/update | 64 --- gcloud/ml-engine/local/help | 30 -- gcloud/ml-engine/local/predict | 88 ---- gcloud/ml-engine/local/train | 107 ----- .../ml-engine/models/add-iam-policy-binding | 88 ---- gcloud/ml-engine/models/create | 80 ---- gcloud/ml-engine/models/delete | 47 -- gcloud/ml-engine/models/describe | 46 -- gcloud/ml-engine/models/get-iam-policy | 92 ---- gcloud/ml-engine/models/help | 58 --- .../models/remove-iam-policy-binding | 99 ---- gcloud/ml-engine/models/set-iam-policy | 74 --- gcloud/ml-engine/models/update | 76 --- gcloud/ml-engine/operations/cancel | 44 -- gcloud/ml-engine/operations/describe | 44 -- gcloud/ml-engine/operations/help | 36 -- gcloud/ml-engine/operations/list | 73 --- gcloud/ml-engine/operations/wait | 49 -- gcloud/ml-engine/predict | 106 ----- gcloud/ml-engine/versions/create | 183 -------- gcloud/ml-engine/versions/delete | 47 -- gcloud/ml-engine/versions/describe | 48 -- gcloud/ml-engine/versions/help | 47 -- gcloud/ml-engine/versions/set-default | 52 --- gcloud/ml-engine/versions/update | 136 ------ 357 files changed, 4606 insertions(+), 9471 deletions(-) create mode 100644 gcloud/alpha/compute/health-checks/create/grpc-with-tls create mode 100644 gcloud/alpha/compute/health-checks/update/grpc-with-tls delete mode 100644 gcloud/alpha/ml-engine/explain delete mode 100644 gcloud/alpha/ml-engine/help delete mode 100644 gcloud/alpha/ml-engine/jobs/cancel delete mode 100644 gcloud/alpha/ml-engine/jobs/describe delete mode 100644 gcloud/alpha/ml-engine/jobs/help delete mode 100644 gcloud/alpha/ml-engine/jobs/stream-logs delete mode 100644 gcloud/alpha/ml-engine/jobs/submit/help delete mode 100644 gcloud/alpha/ml-engine/jobs/submit/prediction delete mode 100644 gcloud/alpha/ml-engine/jobs/submit/training delete mode 100644 gcloud/alpha/ml-engine/jobs/update delete mode 100644 gcloud/alpha/ml-engine/local/help delete mode 100644 gcloud/alpha/ml-engine/local/predict delete mode 100644 gcloud/alpha/ml-engine/local/train delete mode 100644 gcloud/alpha/ml-engine/locations/describe delete mode 100644 gcloud/alpha/ml-engine/locations/help delete mode 100644 gcloud/alpha/ml-engine/models/add-iam-policy-binding delete mode 100644 gcloud/alpha/ml-engine/models/create delete mode 100644 gcloud/alpha/ml-engine/models/delete delete mode 100644 gcloud/alpha/ml-engine/models/describe delete mode 100644 gcloud/alpha/ml-engine/models/get-iam-policy delete mode 100644 gcloud/alpha/ml-engine/models/help delete mode 100644 gcloud/alpha/ml-engine/models/list delete mode 100644 gcloud/alpha/ml-engine/models/remove-iam-policy-binding delete mode 100644 gcloud/alpha/ml-engine/models/set-iam-policy delete mode 100644 gcloud/alpha/ml-engine/models/update delete mode 100644 gcloud/alpha/ml-engine/operations/cancel delete mode 100644 gcloud/alpha/ml-engine/operations/describe delete mode 100644 gcloud/alpha/ml-engine/operations/help delete mode 100644 gcloud/alpha/ml-engine/operations/list delete mode 100644 gcloud/alpha/ml-engine/operations/wait delete mode 100644 gcloud/alpha/ml-engine/predict delete mode 100644 gcloud/alpha/ml-engine/versions/create delete mode 100644 gcloud/alpha/ml-engine/versions/delete delete mode 100644 gcloud/alpha/ml-engine/versions/describe delete mode 100644 gcloud/alpha/ml-engine/versions/help delete mode 100644 gcloud/alpha/ml-engine/versions/list delete mode 100644 gcloud/alpha/ml-engine/versions/set-default delete mode 100644 gcloud/alpha/ml-engine/versions/update delete mode 100644 gcloud/beta/ml-engine/explain delete mode 100644 gcloud/beta/ml-engine/help delete mode 100644 gcloud/beta/ml-engine/jobs/cancel delete mode 100644 gcloud/beta/ml-engine/jobs/describe delete mode 100644 gcloud/beta/ml-engine/jobs/help delete mode 100644 gcloud/beta/ml-engine/jobs/stream-logs delete mode 100644 gcloud/beta/ml-engine/jobs/submit/help delete mode 100644 gcloud/beta/ml-engine/jobs/submit/prediction delete mode 100644 gcloud/beta/ml-engine/jobs/submit/training delete mode 100644 gcloud/beta/ml-engine/jobs/update delete mode 100644 gcloud/beta/ml-engine/local/help delete mode 100644 gcloud/beta/ml-engine/local/predict delete mode 100644 gcloud/beta/ml-engine/local/train delete mode 100644 gcloud/beta/ml-engine/models/add-iam-policy-binding delete mode 100644 gcloud/beta/ml-engine/models/create delete mode 100644 gcloud/beta/ml-engine/models/delete delete mode 100644 gcloud/beta/ml-engine/models/describe delete mode 100644 gcloud/beta/ml-engine/models/get-iam-policy delete mode 100644 gcloud/beta/ml-engine/models/help delete mode 100644 gcloud/beta/ml-engine/models/list delete mode 100644 gcloud/beta/ml-engine/models/remove-iam-policy-binding delete mode 100644 gcloud/beta/ml-engine/models/set-iam-policy delete mode 100644 gcloud/beta/ml-engine/models/update delete mode 100644 gcloud/beta/ml-engine/operations/cancel delete mode 100644 gcloud/beta/ml-engine/operations/describe delete mode 100644 gcloud/beta/ml-engine/operations/help delete mode 100644 gcloud/beta/ml-engine/operations/wait delete mode 100644 gcloud/beta/ml-engine/predict delete mode 100644 gcloud/beta/ml-engine/versions/create delete mode 100644 gcloud/beta/ml-engine/versions/delete delete mode 100644 gcloud/beta/ml-engine/versions/describe delete mode 100644 gcloud/beta/ml-engine/versions/help delete mode 100644 gcloud/beta/ml-engine/versions/list delete mode 100644 gcloud/beta/ml-engine/versions/set-default delete mode 100644 gcloud/beta/ml-engine/versions/update create mode 100644 gcloud/container/ai/help create mode 100644 gcloud/container/ai/profiles/benchmarks/help rename gcloud/{ml-engine/models => container/ai/profiles/benchmarks}/list (68%) create mode 100644 gcloud/container/ai/profiles/help create mode 100644 gcloud/container/ai/profiles/list create mode 100644 gcloud/container/ai/profiles/manifests/create create mode 100644 gcloud/container/ai/profiles/manifests/help create mode 100644 gcloud/container/ai/profiles/model-server-versions/help rename gcloud/{alpha/ml-engine/jobs => container/ai/profiles/model-server-versions}/list (75%) create mode 100644 gcloud/container/ai/profiles/model-servers/help rename gcloud/{beta/ml-engine/jobs => container/ai/profiles/model-servers}/list (77%) create mode 100644 gcloud/container/ai/profiles/models/help rename gcloud/{ml-engine/jobs => container/ai/profiles/models}/list (81%) create mode 100644 gcloud/container/fleet/packages/create create mode 100644 gcloud/container/fleet/packages/delete create mode 100644 gcloud/container/fleet/packages/describe create mode 100644 gcloud/container/fleet/packages/help rename gcloud/{alpha/ml-engine/locations => container/fleet/packages}/list (74%) create mode 100644 gcloud/container/fleet/packages/resource-bundles/create create mode 100644 gcloud/container/fleet/packages/resource-bundles/delete create mode 100644 gcloud/container/fleet/packages/resource-bundles/describe create mode 100644 gcloud/container/fleet/packages/resource-bundles/help create mode 100644 gcloud/container/fleet/packages/resource-bundles/list create mode 100644 gcloud/container/fleet/packages/resource-bundles/releases/create create mode 100644 gcloud/container/fleet/packages/resource-bundles/releases/delete create mode 100644 gcloud/container/fleet/packages/resource-bundles/releases/describe create mode 100644 gcloud/container/fleet/packages/resource-bundles/releases/help rename gcloud/{ml-engine/versions => container/fleet/packages/resource-bundles/releases}/list (70%) create mode 100644 gcloud/container/fleet/packages/resource-bundles/releases/update create mode 100644 gcloud/container/fleet/packages/resource-bundles/update create mode 100644 gcloud/container/fleet/packages/rollouts/abort create mode 100644 gcloud/container/fleet/packages/rollouts/describe create mode 100644 gcloud/container/fleet/packages/rollouts/help create mode 100644 gcloud/container/fleet/packages/rollouts/list create mode 100644 gcloud/container/fleet/packages/rollouts/resume create mode 100644 gcloud/container/fleet/packages/rollouts/suspend create mode 100644 gcloud/container/fleet/packages/update create mode 100644 gcloud/container/hub/packages/create create mode 100644 gcloud/container/hub/packages/delete create mode 100644 gcloud/container/hub/packages/describe create mode 100644 gcloud/container/hub/packages/help create mode 100644 gcloud/container/hub/packages/list create mode 100644 gcloud/container/hub/packages/resource-bundles/create create mode 100644 gcloud/container/hub/packages/resource-bundles/delete create mode 100644 gcloud/container/hub/packages/resource-bundles/describe create mode 100644 gcloud/container/hub/packages/resource-bundles/help create mode 100644 gcloud/container/hub/packages/resource-bundles/list create mode 100644 gcloud/container/hub/packages/resource-bundles/releases/create create mode 100644 gcloud/container/hub/packages/resource-bundles/releases/delete create mode 100644 gcloud/container/hub/packages/resource-bundles/releases/describe create mode 100644 gcloud/container/hub/packages/resource-bundles/releases/help rename gcloud/{beta/ml-engine/operations => container/hub/packages/resource-bundles/releases}/list (67%) create mode 100644 gcloud/container/hub/packages/resource-bundles/releases/update create mode 100644 gcloud/container/hub/packages/resource-bundles/update create mode 100644 gcloud/container/hub/packages/rollouts/abort create mode 100644 gcloud/container/hub/packages/rollouts/describe create mode 100644 gcloud/container/hub/packages/rollouts/help create mode 100644 gcloud/container/hub/packages/rollouts/list create mode 100644 gcloud/container/hub/packages/rollouts/resume create mode 100644 gcloud/container/hub/packages/rollouts/suspend create mode 100644 gcloud/container/hub/packages/update delete mode 100644 gcloud/ml-engine/help delete mode 100644 gcloud/ml-engine/jobs/cancel delete mode 100644 gcloud/ml-engine/jobs/describe delete mode 100644 gcloud/ml-engine/jobs/help delete mode 100644 gcloud/ml-engine/jobs/stream-logs delete mode 100644 gcloud/ml-engine/jobs/submit/help delete mode 100644 gcloud/ml-engine/jobs/submit/prediction delete mode 100644 gcloud/ml-engine/jobs/submit/training delete mode 100644 gcloud/ml-engine/jobs/update delete mode 100644 gcloud/ml-engine/local/help delete mode 100644 gcloud/ml-engine/local/predict delete mode 100644 gcloud/ml-engine/local/train delete mode 100644 gcloud/ml-engine/models/add-iam-policy-binding delete mode 100644 gcloud/ml-engine/models/create delete mode 100644 gcloud/ml-engine/models/delete delete mode 100644 gcloud/ml-engine/models/describe delete mode 100644 gcloud/ml-engine/models/get-iam-policy delete mode 100644 gcloud/ml-engine/models/help delete mode 100644 gcloud/ml-engine/models/remove-iam-policy-binding delete mode 100644 gcloud/ml-engine/models/set-iam-policy delete mode 100644 gcloud/ml-engine/models/update delete mode 100644 gcloud/ml-engine/operations/cancel delete mode 100644 gcloud/ml-engine/operations/describe delete mode 100644 gcloud/ml-engine/operations/help delete mode 100644 gcloud/ml-engine/operations/list delete mode 100644 gcloud/ml-engine/operations/wait delete mode 100644 gcloud/ml-engine/predict delete mode 100644 gcloud/ml-engine/versions/create delete mode 100644 gcloud/ml-engine/versions/delete delete mode 100644 gcloud/ml-engine/versions/describe delete mode 100644 gcloud/ml-engine/versions/help delete mode 100644 gcloud/ml-engine/versions/set-default delete mode 100644 gcloud/ml-engine/versions/update diff --git a/gcloud/_version b/gcloud/_version index 6e3c9c937..c3f365f10 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,8 +1,8 @@ -Google Cloud SDK 533.0.0 -alpha 2025.08.01 -beta 2025.08.01 +Google Cloud SDK 534.0.0 +alpha 2025.08.08 +beta 2025.08.08 bq 2.1.22 bundled-python3-unix 3.12.9 -core 2025.08.01 +core 2025.08.08 gcloud-crc32c 1.0.0 gsutil 5.35 diff --git a/gcloud/ai/endpoints/deploy-model b/gcloud/ai/endpoints/deploy-model index bb29204d3..1475b4dd9 100644 --- a/gcloud/ai/endpoints/deploy-model +++ b/gcloud/ai/endpoints/deploy-model @@ -72,10 +72,10 @@ OPTIONAL FLAGS type The type of the accelerator. Choices are 'nvidia-a100-80gb', - 'nvidia-b200', 'nvidia-h100-80gb', 'nvidia-h100-mega-80gb', - 'nvidia-h200-141gb', 'nvidia-l4', 'nvidia-tesla-a100', - 'nvidia-tesla-k80', 'nvidia-tesla-p100', 'nvidia-tesla-p4', - 'nvidia-tesla-t4', 'nvidia-tesla-v100'. + 'nvidia-b200', 'nvidia-gb200', 'nvidia-h100-80gb', + 'nvidia-h100-mega-80gb', 'nvidia-h200-141gb', 'nvidia-l4', + 'nvidia-tesla-a100', 'nvidia-tesla-k80', 'nvidia-tesla-p100', + 'nvidia-tesla-p4', 'nvidia-tesla-t4', 'nvidia-tesla-v100'. count The number of accelerators to attach to each machine running the diff --git a/gcloud/alpha/access-context-manager/perimeters/create b/gcloud/alpha/access-context-manager/perimeters/create index 3bc75182a..f1e913fd5 100644 --- a/gcloud/alpha/access-context-manager/perimeters/create +++ b/gcloud/alpha/access-context-manager/perimeters/create @@ -9,7 +9,8 @@ SYNOPSIS [--egress-policies=YAML_FILE] [--ingress-policies=YAML_FILE] [--perimeter-type=PERIMETER_TYPE; default="regular"] [--resources=[RESOURCES,...]] [--restricted-services=[SERVICE,...]] - [--enable-vpc-accessible-services + [--vpc-accessible-services=VPC_ACCESSIBLE_SERVICES_YAML_FILE + | --enable-vpc-accessible-services --vpc-allowed-services=[VPC_SERVICE,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -112,14 +113,28 @@ OPTIONAL FLAGS Comma-separated list of services to which the perimeter boundary does apply (for example, storage.googleapis.com). - --enable-vpc-accessible-services - Whether to restrict API calls within the perimeter to those in the - vpc-allowed-services list. + At most one of these can be specified: - --vpc-allowed-services=[VPC_SERVICE,...] - Comma-separated list of APIs accessible from within the Service - Perimeter. In order to include all restricted services, use reference - "RESTRICTED-SERVICES". Requires vpc-accessible-services be enabled. + --vpc-accessible-services=VPC_ACCESSIBLE_SERVICES_YAML_FILE + Path to a YAML file containing the full VPC Accessible Services + configuration. This file should contain a single YAML object + representing a VpcAccessibleServices message as described in the API + reference. This cannot be used with --vpc-allowed-services or + --enable-vpc-accessible-services. + + For more information about the alpha version, see: + https://cloud.google.com/access-context-manager/docs/reference/rest/v1alpha/accessPolicies.servicePerimeters + For more information about non-alpha versions, see: + https://cloud.google.com/access-context-manager/docs/reference/rest/v1/accessPolicies.servicePerimeters + + --enable-vpc-accessible-services + Whether to restrict API calls within the perimeter to those in the + vpc-allowed-services list. + + --vpc-allowed-services=[VPC_SERVICE,...] + Comma-separated list of APIs accessible from within the Service + Perimeter. In order to include all restricted services, use reference + "RESTRICTED-SERVICES". Requires vpc-accessible-services be enabled. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/access-context-manager/perimeters/dry-run/create b/gcloud/alpha/access-context-manager/perimeters/dry-run/create index 86da589ce..4e4d1cd33 100644 --- a/gcloud/alpha/access-context-manager/perimeters/dry-run/create +++ b/gcloud/alpha/access-context-manager/perimeters/dry-run/create @@ -8,7 +8,8 @@ SYNOPSIS (--access-levels=[access_levels,...] --egress-policies=YAML_FILE --ingress-policies=YAML_FILE --resources=[resources,...] --restricted-services=[restricted_services,...] - --enable-vpc-accessible-services + --vpc-accessible-services=VPC_ACCESSIBLE_SERVICES_YAML_FILE + | --enable-vpc-accessible-services --vpc-allowed-services=[vpc_allowed_services,...] | [--perimeter-title=PERIMETER_TITLE --perimeter-type=PERIMETER_TYPE : --perimeter-access-levels=[access_levels,...] @@ -17,7 +18,8 @@ SYNOPSIS --perimeter-ingress-policies=YAML_FILE --perimeter-resources=[resources,...] --perimeter-restricted-services=[restricted_services,...] - --perimeter-enable-vpc-accessible-services + --perimeter-vpc-accessible-services=VPC_ACCESSIBLE_SERVICES_YAML_FILE + | --perimeter-enable-vpc-accessible-services --perimeter-vpc-allowed-services=[vpc_allowed_services,...]]) [--async] [GCLOUD_WIDE_FLAG ...] @@ -112,15 +114,20 @@ REQUIRED FLAGS Comma-separated list of services to which the perimeter boundary does apply (for example, storage.googleapis.com). - --enable-vpc-accessible-services - Whether to restrict API calls within the perimeter to those in the - vpc-allowed-services list. + At most one of these can be specified: - --vpc-allowed-services=[vpc_allowed_services,...] - Comma-separated list of APIs accessible from within the Service - Perimeter. In order to include all restricted services, use - reference "RESTRICTED-SERVICES". Requires vpc-accessible-services - be enabled. + --vpc-accessible-services=VPC_ACCESSIBLE_SERVICES_YAML_FILE + Path to a YAML file containing a VpcAccessibleServices object. + + --enable-vpc-accessible-services + Whether to restrict API calls within the perimeter to those in + the vpc-allowed-services list. + + --vpc-allowed-services=[vpc_allowed_services,...] + Comma-separated list of APIs accessible from within the Service + Perimeter. In order to include all restricted services, use + reference "RESTRICTED-SERVICES". Requires vpc-accessible-services + be enabled. Arguments for creating a dry-run spec for a new Service Perimeter. @@ -180,15 +187,20 @@ REQUIRED FLAGS Comma-separated list of services to which the perimeter boundary does apply (for example, storage.googleapis.com). - --perimeter-enable-vpc-accessible-services - Whether to restrict API calls within the perimeter to those in the - vpc-allowed-services list. + At most one of these can be specified: - --perimeter-vpc-allowed-services=[vpc_allowed_services,...] - Comma-separated list of APIs accessible from within the Service - Perimeter. In order to include all restricted services, use - reference "RESTRICTED-SERVICES". Requires vpc-accessible-services - be enabled. + --perimeter-vpc-accessible-services=VPC_ACCESSIBLE_SERVICES_YAML_FILE + Path to a YAML file containing a VpcAccessibleServices object. + + --perimeter-enable-vpc-accessible-services + Whether to restrict API calls within the perimeter to those in + the vpc-allowed-services list. + + --perimeter-vpc-allowed-services=[vpc_allowed_services,...] + Comma-separated list of APIs accessible from within the Service + Perimeter. In order to include all restricted services, use + reference "RESTRICTED-SERVICES". Requires vpc-accessible-services + be enabled. OPTIONAL FLAGS --async diff --git a/gcloud/alpha/access-context-manager/perimeters/dry-run/update b/gcloud/alpha/access-context-manager/perimeters/dry-run/update index 38c3e969e..746b5a34b 100644 --- a/gcloud/alpha/access-context-manager/perimeters/dry-run/update +++ b/gcloud/alpha/access-context-manager/perimeters/dry-run/update @@ -14,10 +14,12 @@ SYNOPSIS | --remove-restricted-services=[RESTRICTED-SERVICES,...]] [--clear-egress-policies | --set-egress-policies=YAML_FILE] [--clear-ingress-policies | --set-ingress-policies=YAML_FILE] - [--enable-vpc-accessible-services - --add-vpc-allowed-services=[VPC-ALLOWED-SERVICES,...] + [--clear-vpc-accessible-services + | --set-vpc-accessible-services=YAML_FILE + | --enable-vpc-accessible-services + --add-vpc-allowed-services=[VPC_SERVICE,...] | --clear-vpc-allowed-services - | --remove-vpc-allowed-services=[VPC-ALLOWED-SERVICES,...]] + | --remove-vpc-allowed-services=[VPC_SERVICE,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -156,26 +158,44 @@ FLAGS For more information about non-alpha versions, see: https://cloud.google.com/access-context-manager/docs/reference/rest/v1/accessPolicies.servicePerimeters - Arguments for configuring VPC accessible service restrictions. + These flags modify the VpcAccessibleServices of this ServicePerimeter + config. + + At most one of these can be specified: + + --clear-vpc-accessible-services + Empties existing enforced VpcAccessibleServices. + + --set-vpc-accessible-services=YAML_FILE + Path to a file containing a VpcAccessibleServices object. + + This file contains a YAML-compliant object representing + VpcAccessibleServices described in the API reference. + + For more information about the alpha version, see: + https://cloud.google.com/access-context-manager/docs/reference/rest/v1alpha/accessPolicies.servicePerimeters + For more information about non-alpha versions, see: + https://cloud.google.com/access-context-manager/docs/reference/rest/v1/accessPolicies.servicePerimeters --enable-vpc-accessible-services When specified restrict API calls within the Service Perimeter to the set of vpc allowed services. To disable use '--no-enable-vpc-accessible-services'. - These flags modify the member VPC Allowed Services of this Service - Perimeter. + These flags modify the member vpc allowed services of this perimeter. + Services allowed to be called within the Perimeter when VPC Accessible + Services is enabled At most one of these can be specified: - --add-vpc-allowed-services=[VPC-ALLOWED-SERVICES,...] - Append the given values to the current VPC Allowed Services. + --add-vpc-allowed-services=[VPC_SERVICE,...] + Append the given values to the current vpc allowed services. --clear-vpc-allowed-services - Empty the current VPC Allowed Services. + Empty the current vpc allowed services. - --remove-vpc-allowed-services=[VPC-ALLOWED-SERVICES,...] - Remove the given values from the current VPC Allowed Services. + --remove-vpc-allowed-services=[VPC_SERVICE,...] + Remove the given values from the current vpc allowed services. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/access-context-manager/perimeters/update b/gcloud/alpha/access-context-manager/perimeters/update index 6eb0a6d63..29aaa4236 100644 --- a/gcloud/alpha/access-context-manager/perimeters/update +++ b/gcloud/alpha/access-context-manager/perimeters/update @@ -17,7 +17,9 @@ SYNOPSIS | --set-restricted-services=[SERVICE,...]] [--clear-egress-policies | --set-egress-policies=YAML_FILE] [--clear-ingress-policies | --set-ingress-policies=YAML_FILE] - [--enable-vpc-accessible-services + [--clear-vpc-accessible-services + | --set-vpc-accessible-services=YAML_FILE + | --enable-vpc-accessible-services --add-vpc-allowed-services=[VPC_SERVICE,...] | --clear-vpc-allowed-services | --remove-vpc-allowed-services=[VPC_SERVICE,...]] @@ -181,25 +183,44 @@ FLAGS For more information about non-alpha versions, see: https://cloud.google.com/access-context-manager/docs/reference/rest/v1/accessPolicies.servicePerimeters - --enable-vpc-accessible-services - When specified restrict API calls within the Service Perimeter to the - set of vpc allowed services. To disable use - '--no-enable-vpc-accessible-services'. - - These flags modify the member vpc allowed services of this perimeter. - Services allowed to be called within the Perimeter when VPC Accessible - Services is enabled + These flags modify the VpcAccessibleServices of this ServicePerimeter + config. At most one of these can be specified: - --add-vpc-allowed-services=[VPC_SERVICE,...] - Append the given values to the current vpc allowed services. + --clear-vpc-accessible-services + Empties existing enforced VpcAccessibleServices. - --clear-vpc-allowed-services - Empty the current vpc allowed services. + --set-vpc-accessible-services=YAML_FILE + Path to a file containing a VpcAccessibleServices object. - --remove-vpc-allowed-services=[VPC_SERVICE,...] - Remove the given values from the current vpc allowed services. + This file contains a YAML-compliant object representing + VpcAccessibleServices described in the API reference. + + For more information about the alpha version, see: + https://cloud.google.com/access-context-manager/docs/reference/rest/v1alpha/accessPolicies.servicePerimeters + For more information about non-alpha versions, see: + https://cloud.google.com/access-context-manager/docs/reference/rest/v1/accessPolicies.servicePerimeters + + --enable-vpc-accessible-services + When specified restrict API calls within the Service Perimeter to the + set of vpc allowed services. To disable use + '--no-enable-vpc-accessible-services'. + + These flags modify the member vpc allowed services of this perimeter. + Services allowed to be called within the Perimeter when VPC Accessible + Services is enabled + + At most one of these can be specified: + + --add-vpc-allowed-services=[VPC_SERVICE,...] + Append the given values to the current vpc allowed services. + + --clear-vpc-allowed-services + Empty the current vpc allowed services. + + --remove-vpc-allowed-services=[VPC_SERVICE,...] + Remove the given values from the current vpc allowed services. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/alloydb/instances/create b/gcloud/alpha/alloydb/instances/create index 6f80a359d..f57bf4bb8 100644 --- a/gcloud/alpha/alloydb/instances/create +++ b/gcloud/alpha/alloydb/instances/create @@ -15,6 +15,7 @@ SYNOPSIS ...]] [--connection-pooling-max-client-connections=CONNECTION_POOLING_MAX_CLIENT_CONNECTIONS] [--connection-pooling-max-pool-size=CONNECTION_POOLING_MAX_POOL_SIZE] + [--connection-pooling-max-prepared-statements=CONNECTION_POOLING_MAX_PREPARED_STATEMENTS] [--connection-pooling-min-pool-size=CONNECTION_POOLING_MIN_POOL_SIZE] [--connection-pooling-pool-mode=CONNECTION_POOLING_POOL_MODE] [--connection-pooling-query-wait-timeout=CONNECTION_POOLING_QUERY_WAIT_TIMEOUT] @@ -141,6 +142,9 @@ OPTIONAL FLAGS --connection-pooling-max-pool-size=CONNECTION_POOLING_MAX_POOL_SIZE The max pool size for managed connection pooling. + --connection-pooling-max-prepared-statements=CONNECTION_POOLING_MAX_PREPARED_STATEMENTS + The maximum number of prepared statements allowed. + --connection-pooling-min-pool-size=CONNECTION_POOLING_MIN_POOL_SIZE The min pool size for managed connection pooling. diff --git a/gcloud/alpha/alloydb/instances/create-secondary b/gcloud/alpha/alloydb/instances/create-secondary index 3c07f3378..7f77bec68 100644 --- a/gcloud/alpha/alloydb/instances/create-secondary +++ b/gcloud/alpha/alloydb/instances/create-secondary @@ -10,8 +10,20 @@ SYNOPSIS [--assign-inbound-public-ip=ASSIGN_INBOUND_PUBLIC_IP] [--async] [--authorized-external-networks=[AUTHORIZED_NETWORK,...]] [--availability-type=AVAILABILITY_TYPE] + [--connection-pooling-client-connection-idle-timeout=CONNECTION_POOLING_CLIENT_CONNECTION_IDLE_TIMEOUT] + [--connection-pooling-ignore-startup-parameters=[STARTUP_PARAMETERS, + ...]] + [--connection-pooling-max-client-connections=CONNECTION_POOLING_MAX_CLIENT_CONNECTIONS] + [--connection-pooling-max-pool-size=CONNECTION_POOLING_MAX_POOL_SIZE] + [--connection-pooling-max-prepared-statements=CONNECTION_POOLING_MAX_PREPARED_STATEMENTS] + [--connection-pooling-min-pool-size=CONNECTION_POOLING_MIN_POOL_SIZE] + [--connection-pooling-pool-mode=CONNECTION_POOLING_POOL_MODE] + [--connection-pooling-query-wait-timeout=CONNECTION_POOLING_QUERY_WAIT_TIMEOUT] + [--connection-pooling-server-idle-timeout=CONNECTION_POOLING_SERVER_IDLE_TIMEOUT] + [--connection-pooling-server-lifetime=CONNECTION_POOLING_SERVER_LIFETIME] + [--connection-pooling-stats-users=[STATS_USERS,...]] [--database-flags=FLAG=VALUE,[FLAG=VALUE,...]] - [--[no-]outbound-public-ip] + [--[no-]enable-connection-pooling] [--[no-]outbound-public-ip] [--psc-auto-connections=[network=NETWORK],[project=PROJECT]] [--psc-network-attachment-uri=PSC_NETWORK_ATTACHMENT_URI] [--[no-]require-connectors] [--ssl-mode=SSL_MODE] @@ -85,6 +97,51 @@ OPTIONAL FLAGS production instances; instance does not automatically fail over to another zone. + --connection-pooling-client-connection-idle-timeout=CONNECTION_POOLING_CLIENT_CONNECTION_IDLE_TIMEOUT + The maximum number of seconds a client is allowed to be idle before it + is disconnected. + + --connection-pooling-ignore-startup-parameters=[STARTUP_PARAMETERS,...] + Comma-separated list of startup parameters that should be ignored by + the connection pool. + + --connection-pooling-max-client-connections=CONNECTION_POOLING_MAX_CLIENT_CONNECTIONS + The max client connections for managed connection pooling. + + --connection-pooling-max-pool-size=CONNECTION_POOLING_MAX_POOL_SIZE + The max pool size for managed connection pooling. + + --connection-pooling-max-prepared-statements=CONNECTION_POOLING_MAX_PREPARED_STATEMENTS + The maximum number of prepared statements allowed. + + --connection-pooling-min-pool-size=CONNECTION_POOLING_MIN_POOL_SIZE + The min pool size for managed connection pooling. + + --connection-pooling-pool-mode=CONNECTION_POOLING_POOL_MODE + The pool mode for managed connection pooling. + CONNECTION_POOLING_POOL_MODE must be one of: + + SESSION + Session mode for managed connection pooling. + TRANSACTION + Transaction mode for managed connection pooling. + + --connection-pooling-query-wait-timeout=CONNECTION_POOLING_QUERY_WAIT_TIMEOUT + The query wait timeout for managed connection pooling. + + --connection-pooling-server-idle-timeout=CONNECTION_POOLING_SERVER_IDLE_TIMEOUT + The server idle timeout for managed connection pooling. + + --connection-pooling-server-lifetime=CONNECTION_POOLING_SERVER_LIFETIME + The lifetime of a server connection in seconds. The pooler will close + an unused (not currently linked to any client connection) server + connection that has been connected longer than this. Setting it to 0 + means the connection is to be used only once, then closed. + + --connection-pooling-stats-users=[STATS_USERS,...] + Comma-separated list of database users to access connection pooling + stats. + --database-flags=FLAG=VALUE,[FLAG=VALUE,...] Comma-separated list of database flags to set on the instance. Use an equals sign to separate flag name and value. Flags without values, like @@ -93,6 +150,11 @@ OPTIONAL FLAGS API for allowed flags. (e.g., --database-flags max_allowed_packet=55555,skip_grant_tables=,log_output=1) + --[no-]enable-connection-pooling + Enable connection pooling for the instance. Use + --enable-connection-pooling to enable and + --no-enable-connection-pooling to disable. + --[no-]outbound-public-ip Add outbound Public IP connectivity to an AlloyDB instance. Use --outbound-public-ip to enable and --no-outbound-public-ip to disable. diff --git a/gcloud/alpha/alloydb/instances/update b/gcloud/alpha/alloydb/instances/update index 1b9db37f4..f6c5ebd04 100644 --- a/gcloud/alpha/alloydb/instances/update +++ b/gcloud/alpha/alloydb/instances/update @@ -15,6 +15,7 @@ SYNOPSIS ...]] [--connection-pooling-max-client-connections=CONNECTION_POOLING_MAX_CLIENT_CONNECTIONS] [--connection-pooling-max-pool-size=CONNECTION_POOLING_MAX_POOL_SIZE] + [--connection-pooling-max-prepared-statements=CONNECTION_POOLING_MAX_PREPARED_STATEMENTS] [--connection-pooling-min-pool-size=CONNECTION_POOLING_MIN_POOL_SIZE] [--connection-pooling-pool-mode=CONNECTION_POOLING_POOL_MODE] [--connection-pooling-query-wait-timeout=CONNECTION_POOLING_QUERY_WAIT_TIMEOUT] @@ -127,6 +128,9 @@ OPTIONAL FLAGS --connection-pooling-max-pool-size=CONNECTION_POOLING_MAX_POOL_SIZE The max pool size for managed connection pooling. + --connection-pooling-max-prepared-statements=CONNECTION_POOLING_MAX_PREPARED_STATEMENTS + The maximum number of prepared statements allowed. + --connection-pooling-min-pool-size=CONNECTION_POOLING_MIN_POOL_SIZE The min pool size for managed connection pooling. diff --git a/gcloud/alpha/assured/workloads/list b/gcloud/alpha/assured/workloads/list index 43c42ba20..da8655c36 100644 --- a/gcloud/alpha/assured/workloads/list +++ b/gcloud/alpha/assured/workloads/list @@ -21,9 +21,8 @@ EXAMPLES ▪ returning no more than 30 results ▪ requesting 10 results at a time from the backend - $ gcloud alpha assured workloads list \ - organizations/123/locations/us-central1 --limit=30 \ - --page-size=10 + $ gcloud alpha assured workloads list --organization=123 \ + --location=us-central1 --limit=30 --page-size=10 REQUIRED FLAGS --location=LOCATION diff --git a/gcloud/alpha/backup-dr/backup-vaults/create b/gcloud/alpha/backup-dr/backup-vaults/create index bba55de7b..f00001555 100644 --- a/gcloud/alpha/backup-dr/backup-vaults/create +++ b/gcloud/alpha/backup-dr/backup-vaults/create @@ -7,10 +7,9 @@ SYNOPSIS (BACKUP_VAULT : --location=LOCATION) --backup-min-enforced-retention=BACKUP_MIN_ENFORCED_RETENTION [--access-restriction=ACCESS_RESTRICTION; default="within-org"] - [--no-async] - [--backup-retention-inheritance=BACKUP_RETENTION_INHERITANCE] - [--description=DESCRIPTION] [--effective-time=EFFECTIVE_TIME] - [--labels=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] + [--no-async] [--description=DESCRIPTION] + [--effective-time=EFFECTIVE_TIME] [--labels=[KEY=VALUE,...]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Create a Backup and DR backup vault. @@ -102,16 +101,6 @@ OPTIONAL FLAGS --no-async Wait for the operation in progress to complete. - --backup-retention-inheritance=BACKUP_RETENTION_INHERITANCE - The inheritance mode for enforced retention end time of the backup - within this backup vault. Once set, the inheritance mode cannot be - changed. Default is inherit-vault-retention. If set to - inherit-vault-retention, the backup retention period will be inherited - from the backup vault. If set to match-backup-expire-time, the backup - retention period will be the same as the backup expiration time. - BACKUP_RETENTION_INHERITANCE must be one of: inherit-vault-retention, - match-backup-expire-time. - --description=DESCRIPTION Optional description for the backup vault (2048 characters or less). diff --git a/gcloud/alpha/compute/advice/calendar-mode b/gcloud/alpha/compute/advice/calendar-mode index 9966fd8e8..282e11cb3 100644 --- a/gcloud/alpha/compute/advice/calendar-mode +++ b/gcloud/alpha/compute/advice/calendar-mode @@ -101,9 +101,7 @@ OPTIONAL FLAGS specify 1d2h3m4s for a duration of 1 day, 2 hours, 3 minutes, and 4 seconds. - See $ - gcloud topic datetimes for information on duration format. + See $ gcloud topic datetimes for information on duration formats. min The minimum duration of the Future Reservation. @@ -118,9 +116,8 @@ OPTIONAL FLAGS A time range for the end time of the Future Reservation. Defined as a list of key-value pairs. - The key is either "from" or "to", and the value is a datetime. See $ - gcloud topic datetimes for information on time formats. + The key is either "from" or "to", and the value is a datetime. See $ + gcloud topic datetimes for information on time formats. from The earliest possible end time for the reservation. @@ -166,9 +163,8 @@ OPTIONAL FLAGS A time range for the start time of the Future Reservation. Defined as a list of key-value pairs. - The key is either "from" or "to", and the value is a datetime. See $ - gcloud topic datetimes for information on time formats. + The key is either "from" or "to", and the value is a datetime. See $ + gcloud topic datetimes for information on time formats. from The earliest possible start time for the reservation. diff --git a/gcloud/alpha/compute/commitments/create b/gcloud/alpha/compute/commitments/create index 87398b2e4..8772f08f0 100644 --- a/gcloud/alpha/compute/commitments/create +++ b/gcloud/alpha/compute/commitments/create @@ -114,9 +114,9 @@ OPTIONAL FLAGS compute-optimized-h4d, general-purpose, general-purpose-c4, general-purpose-c4a, general-purpose-c4d, general-purpose-e2, general-purpose-n2, general-purpose-n2d, general-purpose-n4, - general-purpose-t2d, graphics-optimized, memory-optimized, - memory-optimized-m3, memory-optimized-m4, memory-optimized-m4-6tb, - memory-optimized-x4, memory-optimized-x4-16tb, + general-purpose-n4d, general-purpose-t2d, graphics-optimized, + memory-optimized, memory-optimized-m3, memory-optimized-m4, + memory-optimized-m4-6tb, memory-optimized-x4, memory-optimized-x4-16tb, memory-optimized-x4-24tb, memory-optimized-x4-32tb, storage-optimized-z3. diff --git a/gcloud/alpha/compute/firewall-policies/mirroring-rules/create b/gcloud/alpha/compute/firewall-policies/mirroring-rules/create index 3b03de404..63cb060f9 100644 --- a/gcloud/alpha/compute/firewall-policies/mirroring-rules/create +++ b/gcloud/alpha/compute/firewall-policies/mirroring-rules/create @@ -5,9 +5,9 @@ NAME SYNOPSIS gcloud alpha compute firewall-policies mirroring-rules create PRIORITY --action=ACTION --firewall-policy=FIREWALL_POLICY - [--description=DESCRIPTION] [--dest-ip-ranges=[DEST_IP_RANGE,...]] - [--direction=DIRECTION] [--[no-]disabled] - [--layer4-configs=[LAYER4_CONFIG,...]] [--organization=ORGANIZATION] + --layer4-configs=[LAYER4_CONFIG,...] [--description=DESCRIPTION] + [--dest-ip-ranges=[DEST_IP_RANGE,...]] [--direction=DIRECTION] + [--[no-]disabled] [--organization=ORGANIZATION] [--security-profile-group=SECURITY_PROFILE_GROUP] [--src-ip-ranges=[SRC_IP_RANGE,...]] [--target-resources=[TARGET_RESOURCES,...]] [GCLOUD_WIDE_FLAG ...] @@ -39,6 +39,10 @@ REQUIRED FLAGS Short name of the firewall policy into which the rule should be inserted. + --layer4-configs=[LAYER4_CONFIG,...] + A list of destination protocols and ports to which the firewall rule + will apply. + OPTIONAL FLAGS --description=DESCRIPTION An optional, textual description for the rule. @@ -54,10 +58,6 @@ OPTIONAL FLAGS Use this flag to disable the rule. Disabled rules will not affect traffic. Use --disabled to enable and --no-disabled to disable. - --layer4-configs=[LAYER4_CONFIG,...] - A list of destination protocols and ports to which the firewall rule - will apply. - --organization=ORGANIZATION Organization which the organization firewall policy belongs to. Must be set if FIREWALL_POLICY is short name. diff --git a/gcloud/alpha/compute/firewall-policies/rules/create b/gcloud/alpha/compute/firewall-policies/rules/create index e6a49d351..1599a9faf 100644 --- a/gcloud/alpha/compute/firewall-policies/rules/create +++ b/gcloud/alpha/compute/firewall-policies/rules/create @@ -5,14 +5,14 @@ NAME SYNOPSIS gcloud alpha compute firewall-policies rules create PRIORITY --action=ACTION --firewall-policy=FIREWALL_POLICY - [--description=DESCRIPTION] + --layer4-configs=[LAYER4_CONFIG,...] [--description=DESCRIPTION] [--dest-address-groups=[DEST_ADDRESS_GROUPS,...]] [--dest-fqdns=[DEST_FQDNS,...]] [--dest-ip-ranges=[DEST_IP_RANGE,...]] [--dest-network-type=DEST_NETWORK_TYPE] [--dest-region-codes=[DEST_REGION_CODES,...]] [--dest-threat-intelligence=[DEST_THREAT_INTELLIGENCE_LISTS,...]] [--direction=DIRECTION] [--[no-]disabled] [--[no-]enable-logging] - [--layer4-configs=[LAYER4_CONFIG,...]] [--organization=ORGANIZATION] + [--organization=ORGANIZATION] [--security-profile-group=SECURITY_PROFILE_GROUP] [--src-address-groups=[SOURCE_ADDRESS_GROUPS,...]] [--src-fqdns=[SOURCE_FQDNS,...]] [--src-ip-ranges=[SRC_IP_RANGE,...]] @@ -51,6 +51,10 @@ REQUIRED FLAGS Short name of the firewall policy into which the rule should be inserted. + --layer4-configs=[LAYER4_CONFIG,...] + A list of destination protocols and ports to which the firewall rule + will apply. + OPTIONAL FLAGS --description=DESCRIPTION An optional, textual description for the rule. @@ -96,10 +100,6 @@ OPTIONAL FLAGS by this rule. Use --enable-logging to enable and --no-enable-logging to disable. - --layer4-configs=[LAYER4_CONFIG,...] - A list of destination protocols and ports to which the firewall rule - will apply. - --organization=ORGANIZATION Organization which the organization firewall policy belongs to. Must be set if FIREWALL_POLICY is short name. diff --git a/gcloud/alpha/compute/health-checks/create/grpc-with-tls b/gcloud/alpha/compute/health-checks/create/grpc-with-tls new file mode 100644 index 000000000..0631f9da9 --- /dev/null +++ b/gcloud/alpha/compute/health-checks/create/grpc-with-tls @@ -0,0 +1,119 @@ +NAME + gcloud alpha compute health-checks create grpc-with-tls - create a gRPC + with TLS health check to monitor load balanced instances + +SYNOPSIS + gcloud alpha compute health-checks create grpc-with-tls NAME + [--check-interval=CHECK_INTERVAL; default="5s"] + [--description=DESCRIPTION] [--enable-logging] + [--grpc-service-name=GRPC_SERVICE_NAME] + [--healthy-threshold=HEALTHY_THRESHOLD; default=2] + [--timeout=TIMEOUT; default="5s"] + [--unhealthy-threshold=UNHEALTHY_THRESHOLD; default=2] + [--global | --region=REGION] [--port=PORT --use-serving-port] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) gcloud alpha compute health-checks create grpc-with-tls is used to + create a non-legacy health check using the gRPC with TLS protocol. You can + use this health check for Google Cloud load balancers or for managed + instance group autohealing. For more information, see the health checks + overview at: + https://cloud.google.com/load-balancing/docs/health-check-concepts + +POSITIONAL ARGUMENTS + NAME + Name of the gRPC with TLS health check to create. + +FLAGS + --check-interval=CHECK_INTERVAL; default="5s" + How often to perform a health check for an instance. For example, + specifying 10s will run the check every 10 seconds. The default value + is 5s. See $ gcloud topic datetimes for information on duration + formats. + + --description=DESCRIPTION + An optional string description for the gRPC with TLS health check. + + --enable-logging + Enable logging of health check probe results to Stackdriver. Logging is + disabled by default. + + Use --no-enable-logging to disable logging. + + --grpc-service-name=GRPC_SERVICE_NAME + An optional gRPC service name string of up to 1024 characters to + include in the gRPC health check request. Only ASCII characters are + allowed. + + --healthy-threshold=HEALTHY_THRESHOLD; default=2 + The number of consecutive successful health checks before an unhealthy + instance is marked as healthy. The default is 2. + + --timeout=TIMEOUT; default="5s" + If Google Compute Engine doesn't receive a healthy response from the + instance by the time specified by the value of this flag, the health + check request is considered a failure. For example, specifying 10s will + cause the check to wait for 10 seconds before considering the request a + failure. The default value is 5s. See $ gcloud topic datetimes for + information on duration formats. + + --unhealthy-threshold=UNHEALTHY_THRESHOLD; default=2 + The number of consecutive health check failures before a healthy + instance is marked as unhealthy. The default is 2. + + At most one of these can be specified: + + --global + If set, the gRPC with TLS health check is global. + + --region=REGION + Region of the gRPC with TLS health check to create. If not specified, + you might be prompted to select a region (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/region property: + + $ gcloud config set compute/region REGION + + A list of regions can be fetched by running: + + $ gcloud compute regions list + + To unset the property, run: + + $ gcloud config unset compute/region + + Alternatively, the region can be stored in the environment variable + CLOUDSDK_COMPUTE_REGION. + + These flags configure the port that the health check monitors. + + --port=PORT + The TCP port number that this health check monitors. + + --use-serving-port + If given, use the "serving port" for health checks: + + ▸ When health checking network endpoints in a Network Endpoint + Group, use the port specified with each endpoint. + --use-serving-port must be used when using a Network Endpoint Group + as a backend as this flag specifies the portSpecification option + for a Health Check object. + ▸ When health checking other backends, use the port of the backend + service. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/compute/health-checks/create/help b/gcloud/alpha/compute/health-checks/create/help index 45e0dd61e..db6a42ab1 100644 --- a/gcloud/alpha/compute/health-checks/create/help +++ b/gcloud/alpha/compute/health-checks/create/help @@ -19,6 +19,10 @@ COMMANDS grpc (ALPHA) Create a gRPC health check to monitor load balanced instances. + grpc-with-tls + (ALPHA) Create a gRPC with TLS health check to monitor load balanced + instances. + http (ALPHA) Create a HTTP health check to monitor load balanced instances. diff --git a/gcloud/alpha/compute/health-checks/update/grpc-with-tls b/gcloud/alpha/compute/health-checks/update/grpc-with-tls new file mode 100644 index 000000000..8dc32e085 --- /dev/null +++ b/gcloud/alpha/compute/health-checks/update/grpc-with-tls @@ -0,0 +1,115 @@ +NAME + gcloud alpha compute health-checks update grpc-with-tls - update a gRPC + with TLS health check + +SYNOPSIS + gcloud alpha compute health-checks update grpc-with-tls NAME + [--check-interval=CHECK_INTERVAL] [--description=DESCRIPTION] + [--enable-logging] [--grpc-service-name=GRPC_SERVICE_NAME] + [--healthy-threshold=HEALTHY_THRESHOLD] [--timeout=TIMEOUT] + [--unhealthy-threshold=UNHEALTHY_THRESHOLD] + [--global | --region=REGION] [--port=PORT --use-serving-port] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) gcloud alpha compute health-checks update grpc-with-tls is used to + update an existing gRPC with TLS health check. Only arguments passed in + will be updated on the health check. Other attributes will remain + unaffected. + +POSITIONAL ARGUMENTS + NAME + Name of the gRPC with TLS health check to update. + +FLAGS + --check-interval=CHECK_INTERVAL + How often to perform a health check for an instance. For example, + specifying 10s will run the check every 10 seconds. See $ gcloud topic + datetimes for information on duration formats. + + --description=DESCRIPTION + A textual description for the gRPC with TLS health check. Pass in an + empty string to unset. + + --enable-logging + Enable logging of health check probe results to Stackdriver. Logging is + disabled by default. + + Use --no-enable-logging to disable logging. + + --grpc-service-name=GRPC_SERVICE_NAME + An optional gRPC service name string of up to 1024 characters to + include in the gRPC health check request. Pass in an empty string to + unset. Only ASCII characters are allowed. + + --healthy-threshold=HEALTHY_THRESHOLD + The number of consecutive successful health checks before an unhealthy + instance is marked as healthy. + + --timeout=TIMEOUT + If Google Compute Engine doesn't receive a healthy response from the + instance by the time specified by the value of this flag, the health + check request is considered a failure. For example, specifying 10s will + cause the check to wait for 10 seconds before considering the request a + failure. See $ gcloud topic datetimes for information on duration + formats. + + --unhealthy-threshold=UNHEALTHY_THRESHOLD + The number of consecutive health check failures before a healthy + instance is marked as unhealthy. + + At most one of these can be specified: + + --global + If set, the gRPC with TLS health check is global. + + --region=REGION + Region of the gRPC with TLS health check to update. If not specified, + you might be prompted to select a region (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/region property: + + $ gcloud config set compute/region REGION + + A list of regions can be fetched by running: + + $ gcloud compute regions list + + To unset the property, run: + + $ gcloud config unset compute/region + + Alternatively, the region can be stored in the environment variable + CLOUDSDK_COMPUTE_REGION. + + These flags configure the port that the health check monitors. + + --port=PORT + The TCP port number that this health check monitors. + + --use-serving-port + If given, use the "serving port" for health checks: + + ▸ When health checking network endpoints in a Network Endpoint + Group, use the port specified with each endpoint. + --use-serving-port must be used when using a Network Endpoint Group + as a backend as this flag specifies the portSpecification option + for a Health Check object. + ▸ When health checking other backends, use the port of the backend + service. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/compute/health-checks/update/help b/gcloud/alpha/compute/health-checks/update/help index 678d5a9ca..6a00f3611 100644 --- a/gcloud/alpha/compute/health-checks/update/help +++ b/gcloud/alpha/compute/health-checks/update/help @@ -19,6 +19,9 @@ COMMANDS grpc (ALPHA) Update a gRPC health check. + grpc-with-tls + (ALPHA) Update a gRPC with TLS health check. + http (ALPHA) Update a HTTP health check. diff --git a/gcloud/alpha/compute/instance-groups/managed/create b/gcloud/alpha/compute/instance-groups/managed/create index 01ab3f9f3..79a91491c 100644 --- a/gcloud/alpha/compute/instance-groups/managed/create +++ b/gcloud/alpha/compute/instance-groups/managed/create @@ -331,19 +331,18 @@ OPTIONAL FLAGS instance group to be part of. --target-size-policy-mode=TARGET_SIZE_POLICY_MODE - Specifies mode in which operations on size are processed. + Specifies the mode in which the MIG creates VMs in the group. TARGET_SIZE_POLICY_MODE must be one of: bulk - Mode in which MIG creates and starts VMs in all-or-nothing manner. - If any VM from the request cannot be provisioned, the whole request - waits for conditions that allow for provisioning whole capacity in - bulk. + MIG creates VMs all at once. If the MIG cannot create any VM to + meet the specified ``size``, then the MIG waits until the resources + become available to create all VMs. individual - Default mode in which MIG creates and starts VMs individually - without cross-dependency between VMs. This means that in case of - something blocking part of VMs to be provisioned, the other part - will be created. + (Default) MIG creates VMs individually. If the MIG cannot create + any VM to meet the specified ``size``, then the MIG creates the VMs + for which resources are available. The MIG then attempts to create + the remaining VMs until the resources become available. --workload-policy=WORKLOAD_POLICY Specifies the workload policy for the managed instance group. It can be diff --git a/gcloud/alpha/compute/instance-templates/create b/gcloud/alpha/compute/instance-templates/create index 41c21ea58..f308cff62 100644 --- a/gcloud/alpha/compute/instance-templates/create +++ b/gcloud/alpha/compute/instance-templates/create @@ -53,7 +53,8 @@ SYNOPSIS [--resource-manager-tags=[KEY=VALUE,...]] [--resource-policies=[RESOURCE_POLICY,...]] [--no-restart-on-failure] [--shielded-integrity-monitoring] [--shielded-secure-boot] - [--shielded-vtpm] [--source-instance=SOURCE_INSTANCE] + [--shielded-vtpm] [--[no-]skip-guest-os-shutdown] + [--source-instance=SOURCE_INSTANCE] [--source-instance-zone=SOURCE_INSTANCE_ZONE] [--stack-type=STACK_TYPE] [--subnet=SUBNET] [--subnet-region=SUBNET_REGION] [--tags=TAG,[TAG,...]] [--termination-time=TERMINATION_TIME] @@ -947,6 +948,12 @@ FLAGS about how to modify Shielded VM options, see https://cloud.google.com/compute/docs/instances/modifying-shielded-vm. + --[no-]skip-guest-os-shutdown + If enabled, then, when the instance is stopped or deleted, the instance + is immediately stopped without giving time to the guest OS to cleanly + shut down. Use --skip-guest-os-shutdown to enable and + --no-skip-guest-os-shutdown to disable. + --source-instance=SOURCE_INSTANCE The name of the source instance that the instance template will be created from. diff --git a/gcloud/alpha/compute/instance-templates/create-with-container b/gcloud/alpha/compute/instance-templates/create-with-container index 971d1c4d4..f1ab35dbf 100644 --- a/gcloud/alpha/compute/instance-templates/create-with-container +++ b/gcloud/alpha/compute/instance-templates/create-with-container @@ -46,7 +46,8 @@ SYNOPSIS [--provisioning-model=PROVISIONING_MODEL] [--region=REGION] [--resource-policies=[RESOURCE_POLICY,...]] [--no-restart-on-failure] [--shielded-integrity-monitoring] [--shielded-secure-boot] - [--shielded-vtpm] [--stack-type=STACK_TYPE] [--subnet=SUBNET] + [--shielded-vtpm] [--[no-]skip-guest-os-shutdown] + [--stack-type=STACK_TYPE] [--subnet=SUBNET] [--subnet-region=SUBNET_REGION] [--tags=TAG,[TAG,...]] [--address=ADDRESS | --no-address] [--custom-cpu=CUSTOM_CPU --custom-memory=CUSTOM_MEMORY @@ -788,6 +789,12 @@ FLAGS about how to modify Shielded VM options, see https://cloud.google.com/compute/docs/instances/modifying-shielded-vm. + --[no-]skip-guest-os-shutdown + If enabled, then, when the instance is stopped or deleted, the instance + is immediately stopped without giving time to the guest OS to cleanly + shut down. Use --skip-guest-os-shutdown to enable and + --no-skip-guest-os-shutdown to disable. + --stack-type=STACK_TYPE Specifies whether IPv6 is enabled on the default network interface. If not specified, IPV4_ONLY will be used. STACK_TYPE must be one of: diff --git a/gcloud/alpha/compute/instances/bulk/create b/gcloud/alpha/compute/instances/bulk/create index 11404b1ba..9263a2006 100644 --- a/gcloud/alpha/compute/instances/bulk/create +++ b/gcloud/alpha/compute/instances/bulk/create @@ -47,7 +47,8 @@ SYNOPSIS [--resource-policies=[RESOURCE_POLICY,...]] [--no-restart-on-failure] [--secure-tags=SECURE_TAG,[SECURE_TAG,...]] [--shielded-integrity-monitoring] [--shielded-secure-boot] - [--shielded-vtpm] [--source-instance-template=SOURCE_INSTANCE_TEMPLATE] + [--shielded-vtpm] [--[no-]skip-guest-os-shutdown] + [--source-instance-template=SOURCE_INSTANCE_TEMPLATE] [--stack-type=STACK_TYPE] [--subnet=SUBNET] [--tags=TAG,[TAG,...]] [--target-distribution-shape=SHAPE] [--termination-time=TERMINATION_TIME] @@ -820,6 +821,12 @@ OPTIONAL FLAGS about how to modify Shielded VM options, see https://cloud.google.com/compute/docs/instances/modifying-shielded-vm. + --[no-]skip-guest-os-shutdown + If enabled, then, when the instance is stopped or deleted, the instance + is immediately stopped without giving time to the guest OS to cleanly + shut down. Use --skip-guest-os-shutdown to enable and + --no-skip-guest-os-shutdown to disable. + --source-instance-template=SOURCE_INSTANCE_TEMPLATE The name of the instance template that the instance will be created from. Users can override fields by specifying other flags. diff --git a/gcloud/alpha/compute/instances/create b/gcloud/alpha/compute/instances/create index fb0a83dd3..e0acb769f 100644 --- a/gcloud/alpha/compute/instances/create +++ b/gcloud/alpha/compute/instances/create @@ -62,7 +62,8 @@ SYNOPSIS [--resource-policies=[RESOURCE_POLICY,...]] [--no-restart-on-failure] [--secure-tags=SECURE_TAG,[SECURE_TAG,...]] [--shielded-integrity-monitoring] [--shielded-secure-boot] - [--shielded-vtpm] [--source-instance-template=SOURCE_INSTANCE_TEMPLATE] + [--shielded-vtpm] [--[no-]skip-guest-os-shutdown] + [--source-instance-template=SOURCE_INSTANCE_TEMPLATE] [--source-machine-image=SOURCE_MACHINE_IMAGE] [--source-machine-image-csek-key-file=FILE] [--stack-type=STACK_TYPE] [--subnet=SUBNET] [--tags=TAG,[TAG,...]] @@ -955,6 +956,12 @@ FLAGS about how to modify Shielded VM options, see https://cloud.google.com/compute/docs/instances/modifying-shielded-vm. + --[no-]skip-guest-os-shutdown + If enabled, then, when the instance is stopped or deleted, the instance + is immediately stopped without giving time to the guest OS to cleanly + shut down. Use --skip-guest-os-shutdown to enable and + --no-skip-guest-os-shutdown to disable. + --source-instance-template=SOURCE_INSTANCE_TEMPLATE The name of the instance template that the instance will be created from. An instance template can be a global/regional resource. diff --git a/gcloud/alpha/compute/instances/create-with-container b/gcloud/alpha/compute/instances/create-with-container index 9c7a785b9..1564f506d 100644 --- a/gcloud/alpha/compute/instances/create-with-container +++ b/gcloud/alpha/compute/instances/create-with-container @@ -57,7 +57,8 @@ SYNOPSIS [--provisioning-model=PROVISIONING_MODEL] [--resource-policies=[RESOURCE_POLICY,...]] [--no-restart-on-failure] [--shielded-integrity-monitoring] [--shielded-secure-boot] - [--shielded-vtpm] [--source-instance-template=SOURCE_INSTANCE_TEMPLATE] + [--shielded-vtpm] [--[no-]skip-guest-os-shutdown] + [--source-instance-template=SOURCE_INSTANCE_TEMPLATE] [--stack-type=STACK_TYPE] [--subnet=SUBNET] [--tags=TAG,[TAG,...]] [--termination-time=TERMINATION_TIME] [--threads-per-core=THREADS_PER_CORE] @@ -883,6 +884,12 @@ FLAGS about how to modify Shielded VM options, see https://cloud.google.com/compute/docs/instances/modifying-shielded-vm. + --[no-]skip-guest-os-shutdown + If enabled, then, when the instance is stopped or deleted, the instance + is immediately stopped without giving time to the guest OS to cleanly + shut down. Use --skip-guest-os-shutdown to enable and + --no-skip-guest-os-shutdown to disable. + --source-instance-template=SOURCE_INSTANCE_TEMPLATE The name of the instance template that the instance will be created from. An instance template can be a global/regional resource. diff --git a/gcloud/alpha/compute/instances/set-scheduling b/gcloud/alpha/compute/instances/set-scheduling index 0778b4a95..3cec6c73d 100644 --- a/gcloud/alpha/compute/instances/set-scheduling +++ b/gcloud/alpha/compute/instances/set-scheduling @@ -10,7 +10,7 @@ SYNOPSIS [--local-ssd-recovery-timeout=LOCAL_SSD_RECOVERY_TIMEOUT] [--min-node-cpu=MIN_NODE_CPU] [--[no-]preemptible] [--provisioning-model=PROVISIONING_MODEL] [--[no-]restart-on-failure] - [--zone=ZONE] + [--[no-]skip-guest-os-shutdown] [--zone=ZONE] [--clear-discard-local-ssds-at-termination-timestamp | --discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP] [--clear-instance-termination-action @@ -103,6 +103,12 @@ FLAGS option is mutually exclusive with --preemptible. Use --restart-on-failure to enable and --no-restart-on-failure to disable. + --[no-]skip-guest-os-shutdown + If enabled, then, when the instance is stopped or deleted, the instance + is immediately stopped without giving time to the guest OS to cleanly + shut down. Use --skip-guest-os-shutdown to enable and + --no-skip-guest-os-shutdown to disable. + --zone=ZONE Zone of the instance to operate on. If not specified, you might be prompted to select a zone (interactive mode only). gcloud attempts to diff --git a/gcloud/alpha/compute/interconnects/application-awareness/configure-bandwidth-percentage-policy b/gcloud/alpha/compute/interconnects/application-awareness/configure-bandwidth-percentage-policy index e58026903..ab93dce77 100644 --- a/gcloud/alpha/compute/interconnects/application-awareness/configure-bandwidth-percentage-policy +++ b/gcloud/alpha/compute/interconnects/application-awareness/configure-bandwidth-percentage-policy @@ -23,8 +23,8 @@ EXAMPLES example-interconnect, run: $ gcloud alpha compute interconnects application-awareness \ configure-bandwidth-percentage-policy example-interconnect \ - --bandwidth-percentages="TC1=11,TC2=10" --enabled \ - --profile_description="some string " + --bandwidth-percentages="TC1=5,TC2=5,TC3=75,TC4=5,TC5=5,TC6=5" \ + --enabled --profile_description="some string" POSITIONAL ARGUMENTS NAME @@ -32,8 +32,21 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --bandwidth-percentages=[TC1=TC1],[TC2=TC2],[TC3=TC3],[TC4=TC4],[TC5=TC5],[TC6=TC6] - A list of bandwidth percentages for each application awareness profile. - The sum of all bandwidth percentages must be 100. + A list of bandwidth percentages, for configuring the bandwidth + percentage policy or traffic shaping. + + For configuring bandwidth percentages for the bandwidth percentage + policy: + + 1. Each bandwidth percentage value must be an integer between 1-100. 2. + It is required to provide a percentage value for each class. 3. The sum + of all bandwidth percentages must be 100. + + For configuring bandwidth percentages for traffic shaping: + + 1. Each bandwidth percentage value must be an integer between 1-100. 2. + It is not required to provide a percentage value for each class. 3. The + sum of all bandwidth percentages does not need to be 100. OPTIONAL FLAGS --enabled diff --git a/gcloud/alpha/compute/interconnects/application-awareness/configure-shaper-average-percentage b/gcloud/alpha/compute/interconnects/application-awareness/configure-shaper-average-percentage index a22d0a884..7ecfd28e6 100644 --- a/gcloud/alpha/compute/interconnects/application-awareness/configure-shaper-average-percentage +++ b/gcloud/alpha/compute/interconnects/application-awareness/configure-shaper-average-percentage @@ -14,7 +14,9 @@ SYNOPSIS DESCRIPTION (ALPHA) gcloud alpha compute interconnects application-awareness configure-shaper-average-percentage is used to configure shaper average - percentage for using application awareness on interconnect. + percentage for using application awareness on interconnect. Note that an + application awareness policy (strict priority or bandwidth percentage) + should be configure before configuring traffic shaping. For an example, refer to the EXAMPLES section below. @@ -23,8 +25,8 @@ EXAMPLES example-interconnect, run: $ gcloud alpha compute interconnects application-awareness \ configure-shaper-average-percentage example-interconnect \ - --bandwidth-percentages="TC1=11,TC2=10" --enabled \ - --profile_description="some string " + --bandwidth-percentages="TC1=30,TC2=90" --enabled \ + --profile_description="some string" POSITIONAL ARGUMENTS NAME @@ -32,8 +34,21 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --bandwidth-percentages=[TC1=TC1],[TC2=TC2],[TC3=TC3],[TC4=TC4],[TC5=TC5],[TC6=TC6] - A list of bandwidth percentages for each application awareness profile. - The sum of all bandwidth percentages must be 100. + A list of bandwidth percentages, for configuring the bandwidth + percentage policy or traffic shaping. + + For configuring bandwidth percentages for the bandwidth percentage + policy: + + 1. Each bandwidth percentage value must be an integer between 1-100. 2. + It is required to provide a percentage value for each class. 3. The sum + of all bandwidth percentages must be 100. + + For configuring bandwidth percentages for traffic shaping: + + 1. Each bandwidth percentage value must be an integer between 1-100. 2. + It is not required to provide a percentage value for each class. 3. The + sum of all bandwidth percentages does not need to be 100. OPTIONAL FLAGS --enabled diff --git a/gcloud/alpha/compute/network-firewall-policies/mirroring-rules/create b/gcloud/alpha/compute/network-firewall-policies/mirroring-rules/create index cec6ff0ef..c1b125bbd 100644 --- a/gcloud/alpha/compute/network-firewall-policies/mirroring-rules/create +++ b/gcloud/alpha/compute/network-firewall-policies/mirroring-rules/create @@ -5,9 +5,9 @@ NAME SYNOPSIS gcloud alpha compute network-firewall-policies mirroring-rules create PRIORITY --action=ACTION --firewall-policy=FIREWALL_POLICY - --global-firewall-policy [--description=DESCRIPTION] - [--dest-ip-ranges=[DEST_IP_RANGE,...]] [--direction=DIRECTION] - [--[no-]disabled] [--layer4-configs=[LAYER4_CONFIG,...]] + --global-firewall-policy --layer4-configs=[LAYER4_CONFIG,...] + [--description=DESCRIPTION] [--dest-ip-ranges=[DEST_IP_RANGE,...]] + [--direction=DIRECTION] [--[no-]disabled] [--security-profile-group=SECURITY_PROFILE_GROUP] [--src-ip-ranges=[SRC_IP_RANGE,...]] [--target-secure-tags=[TARGET_SECURE_TAGS,...]] [GCLOUD_WIDE_FLAG ...] @@ -39,6 +39,10 @@ REQUIRED FLAGS --global-firewall-policy Use this flag to indicate that firewall policy is global. + --layer4-configs=[LAYER4_CONFIG,...] + A list of destination protocols and ports to which the firewall rule + will apply. + OPTIONAL FLAGS --description=DESCRIPTION An optional, textual description for the rule. @@ -54,10 +58,6 @@ OPTIONAL FLAGS Use this flag to disable the rule. Disabled rules will not affect traffic. Use --disabled to enable and --no-disabled to disable. - --layer4-configs=[LAYER4_CONFIG,...] - A list of destination protocols and ports to which the firewall rule - will apply. - --security-profile-group=SECURITY_PROFILE_GROUP A security profile group to be used with mirror action. diff --git a/gcloud/alpha/compute/network-firewall-policies/rules/create b/gcloud/alpha/compute/network-firewall-policies/rules/create index 47ac2ba01..e9907ed6f 100644 --- a/gcloud/alpha/compute/network-firewall-policies/rules/create +++ b/gcloud/alpha/compute/network-firewall-policies/rules/create @@ -5,14 +5,13 @@ NAME SYNOPSIS gcloud alpha compute network-firewall-policies rules create PRIORITY --action=ACTION --firewall-policy=FIREWALL_POLICY - [--description=DESCRIPTION] + --layer4-configs=[LAYER4_CONFIG,...] [--description=DESCRIPTION] [--dest-address-groups=[DEST_ADDRESS_GROUPS,...]] [--dest-fqdns=[DEST_FQDNS,...]] [--dest-ip-ranges=[DEST_IP_RANGE,...]] [--dest-network-type=DEST_NETWORK_TYPE] [--dest-region-codes=[DEST_REGION_CODES,...]] [--dest-threat-intelligence=[DEST_THREAT_INTELLIGENCE_LISTS,...]] [--direction=DIRECTION] [--[no-]disabled] [--[no-]enable-logging] - [--layer4-configs=[LAYER4_CONFIG,...]] [--security-profile-group=SECURITY_PROFILE_GROUP] [--src-address-groups=[SOURCE_ADDRESS_GROUPS,...]] [--src-fqdns=[SOURCE_FQDNS,...]] [--src-ip-ranges=[SRC_IP_RANGE,...]] @@ -60,6 +59,10 @@ REQUIRED FLAGS --firewall-policy=FIREWALL_POLICY Firewall policy ID with which to create rule. + --layer4-configs=[LAYER4_CONFIG,...] + A list of destination protocols and ports to which the firewall rule + will apply. + OPTIONAL FLAGS --description=DESCRIPTION An optional, textual description for the rule. @@ -105,10 +108,6 @@ OPTIONAL FLAGS by this rule. Use --enable-logging to enable and --no-enable-logging to disable. - --layer4-configs=[LAYER4_CONFIG,...] - A list of destination protocols and ports to which the firewall rule - will apply. - --security-profile-group=SECURITY_PROFILE_GROUP A security profile group to be used with apply_security_profile_group action. diff --git a/gcloud/alpha/compute/preview-features/update b/gcloud/alpha/compute/preview-features/update index 61718e611..f5a839e37 100644 --- a/gcloud/alpha/compute/preview-features/update +++ b/gcloud/alpha/compute/preview-features/update @@ -12,8 +12,8 @@ DESCRIPTION (ALPHA) Update a preview feature's activation status. EXAMPLES - To enable/disable a preview feature's activation status, run the following - command: + To enable/unspecify a preview feature's activation status, run the + following command: $ gcloud alpha compute preview-features update @@ -40,7 +40,7 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --activation-status=ACTIVATION_STATUS The activation status of the preview feature. ACTIVATION_STATUS must be - one of: disabled, enabled. + one of: enabled, unspecified. The rollout plan of the preview feature. diff --git a/gcloud/alpha/compute/public-delegated-prefixes/create b/gcloud/alpha/compute/public-delegated-prefixes/create index e7efcc649..7dd259aa6 100644 --- a/gcloud/alpha/compute/public-delegated-prefixes/create +++ b/gcloud/alpha/compute/public-delegated-prefixes/create @@ -8,7 +8,7 @@ SYNOPSIS | --public-delegated-prefix=PUBLIC_DELEGATED_PREFIX) [--allocatable-prefix-length=ALLOCATABLE_PREFIX_LENGTH] [--description=DESCRIPTION] [--enable-live-migration] [--mode=MODE] - [--global | --region=REGION] [GCLOUD_WIDE_FLAG ...] + [--purpose=PURPOSE] [--global | --region=REGION] [GCLOUD_WIDE_FLAG ...] EXAMPLES To create a public delegated prefix: @@ -51,6 +51,13 @@ OPTIONAL FLAGS external-ipv6-forwarding-rule-creation, external-ipv6-subnetwork-creation, internal-ipv6-subnetwork-creation. + --purpose=PURPOSE + The purpose of the public delegated prefix. This field can only be set + for the top-level global public delegated prefix. PURPOSE must be one + of: APPLICATION_AND_PROXY_LOAD_BALANCERS, + PASSTHROUGH_LOAD_BALANCER_AVAILABILITY_GROUP0, + PASSTHROUGH_LOAD_BALANCER_AVAILABILITY_GROUP1. + At most one of these can be specified: --global diff --git a/gcloud/alpha/compute/queued-resources/create b/gcloud/alpha/compute/queued-resources/create index 7e97f7313..9e84b2285 100644 --- a/gcloud/alpha/compute/queued-resources/create +++ b/gcloud/alpha/compute/queued-resources/create @@ -47,7 +47,8 @@ SYNOPSIS [--resource-policies=[RESOURCE_POLICY,...]] [--no-restart-on-failure] [--secure-tags=SECURE_TAG,[SECURE_TAG,...]] [--shielded-integrity-monitoring] [--shielded-secure-boot] - [--shielded-vtpm] [--source-instance-template=SOURCE_INSTANCE_TEMPLATE] + [--shielded-vtpm] [--[no-]skip-guest-os-shutdown] + [--source-instance-template=SOURCE_INSTANCE_TEMPLATE] [--stack-type=STACK_TYPE] [--subnet=SUBNET] [--tags=TAG,[TAG,...]] [--target-distribution-shape=SHAPE] [--termination-time=TERMINATION_TIME] @@ -796,6 +797,12 @@ OPTIONAL FLAGS about how to modify Shielded VM options, see https://cloud.google.com/compute/docs/instances/modifying-shielded-vm. + --[no-]skip-guest-os-shutdown + If enabled, then, when the instance is stopped or deleted, the instance + is immediately stopped without giving time to the guest OS to cleanly + shut down. Use --skip-guest-os-shutdown to enable and + --no-skip-guest-os-shutdown to disable. + --source-instance-template=SOURCE_INSTANCE_TEMPLATE The name of the instance template that the instance will be created from. Users can override fields by specifying other flags. diff --git a/gcloud/alpha/container/ai/help b/gcloud/alpha/container/ai/help index 8adf97f81..c9f9c11b0 100644 --- a/gcloud/alpha/container/ai/help +++ b/gcloud/alpha/container/ai/help @@ -22,5 +22,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud container ai diff --git a/gcloud/alpha/container/ai/profiles/help b/gcloud/alpha/container/ai/profiles/help index da7110667..d5f38553f 100644 --- a/gcloud/alpha/container/ai/profiles/help +++ b/gcloud/alpha/container/ai/profiles/help @@ -47,5 +47,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud container ai profiles diff --git a/gcloud/alpha/container/ai/profiles/manifests/create b/gcloud/alpha/container/ai/profiles/manifests/create index 74ff267b2..601583d70 100644 --- a/gcloud/alpha/container/ai/profiles/manifests/create +++ b/gcloud/alpha/container/ai/profiles/manifests/create @@ -66,5 +66,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud container ai profiles manifests create diff --git a/gcloud/alpha/container/ai/profiles/manifests/help b/gcloud/alpha/container/ai/profiles/manifests/help index afb6ee9cf..a608587c3 100644 --- a/gcloud/alpha/container/ai/profiles/manifests/help +++ b/gcloud/alpha/container/ai/profiles/manifests/help @@ -24,5 +24,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud container ai profiles manifests diff --git a/gcloud/alpha/container/ai/profiles/model-server-versions/help b/gcloud/alpha/container/ai/profiles/model-server-versions/help index dfa97a43d..eb54c4f71 100644 --- a/gcloud/alpha/container/ai/profiles/model-server-versions/help +++ b/gcloud/alpha/container/ai/profiles/model-server-versions/help @@ -25,5 +25,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud container ai profiles model-server-versions diff --git a/gcloud/alpha/container/ai/profiles/model-server-versions/list b/gcloud/alpha/container/ai/profiles/model-server-versions/list index 511323f74..23a884c84 100644 --- a/gcloud/alpha/container/ai/profiles/model-server-versions/list +++ b/gcloud/alpha/container/ai/profiles/model-server-versions/list @@ -66,5 +66,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud container ai profiles model-server-versions list diff --git a/gcloud/alpha/container/ai/profiles/model-servers/help b/gcloud/alpha/container/ai/profiles/model-servers/help index 6a29ab9d5..618f54b08 100644 --- a/gcloud/alpha/container/ai/profiles/model-servers/help +++ b/gcloud/alpha/container/ai/profiles/model-servers/help @@ -24,5 +24,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud container ai profiles model-servers diff --git a/gcloud/alpha/container/ai/profiles/model-servers/list b/gcloud/alpha/container/ai/profiles/model-servers/list index 9434e9b6e..0d1acb0b5 100644 --- a/gcloud/alpha/container/ai/profiles/model-servers/list +++ b/gcloud/alpha/container/ai/profiles/model-servers/list @@ -60,5 +60,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud container ai profiles model-servers list diff --git a/gcloud/alpha/container/ai/profiles/models/help b/gcloud/alpha/container/ai/profiles/models/help index 952e402a2..e93580dff 100644 --- a/gcloud/alpha/container/ai/profiles/models/help +++ b/gcloud/alpha/container/ai/profiles/models/help @@ -23,5 +23,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud container ai profiles models diff --git a/gcloud/alpha/container/ai/profiles/models/list b/gcloud/alpha/container/ai/profiles/models/list index 3ef529ccf..d6c3b4705 100644 --- a/gcloud/alpha/container/ai/profiles/models/list +++ b/gcloud/alpha/container/ai/profiles/models/list @@ -53,5 +53,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud container ai profiles models list diff --git a/gcloud/alpha/container/fleet/config-management/disable b/gcloud/alpha/container/fleet/config-management/disable index 548b0401a..6d1862657 100644 --- a/gcloud/alpha/container/fleet/config-management/disable +++ b/gcloud/alpha/container/fleet/config-management/disable @@ -1,40 +1,102 @@ NAME - gcloud alpha container fleet config-management disable - disable Config + gcloud alpha container fleet config-management disable - disable the Config Management feature SYNOPSIS - gcloud alpha container fleet config-management disable - [--fleet-default-member-config | --force] [GCLOUD_WIDE_FLAG ...] + gcloud alpha container fleet config-management disable [--force] + [--fleet-default-member-config | --uninstall --all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Disable the Config Management feature in a fleet. Disable the - feature entirely or only disable fleet-default membership configuration - (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features) - for the feature. + (ALPHA) Disable the Config Management feature entirely, or disable specific + configuration on the feature. + + gcloud alpha container fleet config-management disable without flags + deletes the Config Management feature, which unmanages and leaves existing + Config Sync installations on membership clusters. Running the command + without flags exits silently if the feature does not exist. Specify flags + to disable configuration on parts of the feature without deleting it. EXAMPLES To disable the Config Management feature entirely, run: $ gcloud alpha container fleet config-management disable - To disable only fleet-default membership configuration for the feature, - run: + To unmanage Config Sync only on select memberships, run: $ gcloud alpha container fleet config-management disable \ - --fleet-default-member-config + --memberships=example-membership-1,example-membership-2 FLAGS + --force + Force disablement. Bypasses any prompts for confirmation. When + disabling the entire feature, proceeds even if the feature is in use. + Might result in unexpected behavior. + At most one of these can be specified: --fleet-default-member-config Disable the fleet-default membership configuration (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features). - Does not change existing membership configurations. + Does not change existing membership configurations. Does nothing if + the feature is disabled. - --force - Force disablement. Bypasses any prompts for confirmation. When - disabling the entire feature, proceeds even if the feature is in use. - Might result in unexpected behavior. + Membership-specific flags. In the absence of --uninstall, using either + --memberships or --all-memberships removes the entire configuration for + the specified memberships, which unmanages and leaves existing Config + Sync installations on the membership clusters. Unmanagement does not + error if the feature is disabled. + + --uninstall + Uninstall any previously-installed and managed Config Sync on the + specified memberships by setting the enabled field + (https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/reference/gcloud-apply-fields) + to false. Clears all other configuration for each membership. Does + not wait for the uninstallation to complete. To bypass the + confirmation prompt, use --force. Requires the feature to be + enabled. + + To uninstall Config Sync on select memberships, run: + + $ gcloud alpha container fleet config-management disable \ + --uninstall \ + --memberships=example-membership-1,example-membership-2 + + At most one of these can be specified: + + --all-memberships + All 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, diff --git a/gcloud/alpha/container/fleet/config-management/help b/gcloud/alpha/container/fleet/config-management/help index 452f3952a..d8dd200e1 100644 --- a/gcloud/alpha/container/fleet/config-management/help +++ b/gcloud/alpha/container/fleet/config-management/help @@ -28,7 +28,7 @@ COMMANDS given membership. disable - (ALPHA) Disable Config Management feature. + (ALPHA) Disable the Config Management feature. enable (ALPHA) Enable Config Management feature. diff --git a/gcloud/alpha/container/fleet/packages/create b/gcloud/alpha/container/fleet/packages/create index 44cad46b6..786b3ba50 100644 --- a/gcloud/alpha/container/fleet/packages/create +++ b/gcloud/alpha/container/fleet/packages/create @@ -39,7 +39,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container fleet packages create $ gcloud beta container fleet packages create diff --git a/gcloud/alpha/container/fleet/packages/delete b/gcloud/alpha/container/fleet/packages/delete index 9c7093f2e..3fed129e8 100644 --- a/gcloud/alpha/container/fleet/packages/delete +++ b/gcloud/alpha/container/fleet/packages/delete @@ -64,7 +64,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container fleet packages delete $ gcloud beta container fleet packages delete diff --git a/gcloud/alpha/container/fleet/packages/describe b/gcloud/alpha/container/fleet/packages/describe index ce9670533..c860f57f4 100644 --- a/gcloud/alpha/container/fleet/packages/describe +++ b/gcloud/alpha/container/fleet/packages/describe @@ -64,7 +64,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container fleet packages describe $ gcloud beta container fleet packages describe diff --git a/gcloud/alpha/container/fleet/packages/help b/gcloud/alpha/container/fleet/packages/help index 1649f7cf2..f0a4c3318 100644 --- a/gcloud/alpha/container/fleet/packages/help +++ b/gcloud/alpha/container/fleet/packages/help @@ -44,7 +44,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container fleet packages $ gcloud beta container fleet packages diff --git a/gcloud/alpha/container/fleet/packages/list b/gcloud/alpha/container/fleet/packages/list index 0fda9ed93..71c11cad0 100644 --- a/gcloud/alpha/container/fleet/packages/list +++ b/gcloud/alpha/container/fleet/packages/list @@ -63,7 +63,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container fleet packages list $ gcloud beta container fleet packages list diff --git a/gcloud/alpha/container/fleet/packages/resource-bundles/create b/gcloud/alpha/container/fleet/packages/resource-bundles/create index d8c5a8e78..bf22e3e78 100644 --- a/gcloud/alpha/container/fleet/packages/resource-bundles/create +++ b/gcloud/alpha/container/fleet/packages/resource-bundles/create @@ -39,7 +39,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container fleet packages resource-bundles create $ gcloud beta container fleet packages resource-bundles create diff --git a/gcloud/alpha/container/fleet/packages/resource-bundles/delete b/gcloud/alpha/container/fleet/packages/resource-bundles/delete index edc190a7b..8e33eeba1 100644 --- a/gcloud/alpha/container/fleet/packages/resource-bundles/delete +++ b/gcloud/alpha/container/fleet/packages/resource-bundles/delete @@ -39,7 +39,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container fleet packages resource-bundles delete $ gcloud beta container fleet packages resource-bundles delete diff --git a/gcloud/alpha/container/fleet/packages/resource-bundles/describe b/gcloud/alpha/container/fleet/packages/resource-bundles/describe index a4daa12a9..e3aae930f 100644 --- a/gcloud/alpha/container/fleet/packages/resource-bundles/describe +++ b/gcloud/alpha/container/fleet/packages/resource-bundles/describe @@ -35,7 +35,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container fleet packages resource-bundles describe $ gcloud beta container fleet packages resource-bundles describe diff --git a/gcloud/alpha/container/fleet/packages/resource-bundles/help b/gcloud/alpha/container/fleet/packages/resource-bundles/help index bb609c613..7fa6e9abe 100644 --- a/gcloud/alpha/container/fleet/packages/resource-bundles/help +++ b/gcloud/alpha/container/fleet/packages/resource-bundles/help @@ -43,7 +43,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container fleet packages resource-bundles $ gcloud beta container fleet packages resource-bundles diff --git a/gcloud/alpha/container/fleet/packages/resource-bundles/list b/gcloud/alpha/container/fleet/packages/resource-bundles/list index bc9323b56..d5692f21a 100644 --- a/gcloud/alpha/container/fleet/packages/resource-bundles/list +++ b/gcloud/alpha/container/fleet/packages/resource-bundles/list @@ -65,7 +65,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container fleet packages resource-bundles list $ gcloud beta container fleet packages resource-bundles list diff --git a/gcloud/alpha/container/fleet/packages/resource-bundles/releases/create b/gcloud/alpha/container/fleet/packages/resource-bundles/releases/create index 7c186bfbf..8b253190e 100644 --- a/gcloud/alpha/container/fleet/packages/resource-bundles/releases/create +++ b/gcloud/alpha/container/fleet/packages/resource-bundles/releases/create @@ -69,7 +69,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container fleet packages resource-bundles releases create $ gcloud beta container fleet packages resource-bundles releases \ create diff --git a/gcloud/alpha/container/fleet/packages/resource-bundles/releases/delete b/gcloud/alpha/container/fleet/packages/resource-bundles/releases/delete index 221b8efa3..dd0400760 100644 --- a/gcloud/alpha/container/fleet/packages/resource-bundles/releases/delete +++ b/gcloud/alpha/container/fleet/packages/resource-bundles/releases/delete @@ -45,7 +45,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container fleet packages resource-bundles releases delete $ gcloud beta container fleet packages resource-bundles releases \ delete diff --git a/gcloud/alpha/container/fleet/packages/resource-bundles/releases/describe b/gcloud/alpha/container/fleet/packages/resource-bundles/releases/describe index 91028ae9f..6047fd356 100644 --- a/gcloud/alpha/container/fleet/packages/resource-bundles/releases/describe +++ b/gcloud/alpha/container/fleet/packages/resource-bundles/releases/describe @@ -41,7 +41,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container fleet packages resource-bundles releases describe $ gcloud beta container fleet packages resource-bundles releases \ describe diff --git a/gcloud/alpha/container/fleet/packages/resource-bundles/releases/help b/gcloud/alpha/container/fleet/packages/resource-bundles/releases/help index 64df1a2b1..e88c72ba1 100644 --- a/gcloud/alpha/container/fleet/packages/resource-bundles/releases/help +++ b/gcloud/alpha/container/fleet/packages/resource-bundles/releases/help @@ -37,7 +37,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container fleet packages resource-bundles releases $ gcloud beta container fleet packages resource-bundles releases diff --git a/gcloud/alpha/container/fleet/packages/resource-bundles/releases/list b/gcloud/alpha/container/fleet/packages/resource-bundles/releases/list index dd61f671f..5d850b4e8 100644 --- a/gcloud/alpha/container/fleet/packages/resource-bundles/releases/list +++ b/gcloud/alpha/container/fleet/packages/resource-bundles/releases/list @@ -69,7 +69,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container fleet packages resource-bundles releases list $ gcloud beta container fleet packages resource-bundles releases list diff --git a/gcloud/alpha/container/fleet/packages/resource-bundles/releases/update b/gcloud/alpha/container/fleet/packages/resource-bundles/releases/update index 2737c80a3..f59293558 100644 --- a/gcloud/alpha/container/fleet/packages/resource-bundles/releases/update +++ b/gcloud/alpha/container/fleet/packages/resource-bundles/releases/update @@ -44,7 +44,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container fleet packages resource-bundles releases update $ gcloud beta container fleet packages resource-bundles releases \ update diff --git a/gcloud/alpha/container/fleet/packages/resource-bundles/update b/gcloud/alpha/container/fleet/packages/resource-bundles/update index 1f1c3418c..78df4154d 100644 --- a/gcloud/alpha/container/fleet/packages/resource-bundles/update +++ b/gcloud/alpha/container/fleet/packages/resource-bundles/update @@ -39,7 +39,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container fleet packages resource-bundles update $ gcloud beta container fleet packages resource-bundles update diff --git a/gcloud/alpha/container/fleet/packages/rollouts/abort b/gcloud/alpha/container/fleet/packages/rollouts/abort index 7691f5255..e07cdef9e 100644 --- a/gcloud/alpha/container/fleet/packages/rollouts/abort +++ b/gcloud/alpha/container/fleet/packages/rollouts/abort @@ -70,7 +70,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container fleet packages rollouts abort $ gcloud beta container fleet packages rollouts abort diff --git a/gcloud/alpha/container/fleet/packages/rollouts/describe b/gcloud/alpha/container/fleet/packages/rollouts/describe index 29a54d006..1dc052aeb 100644 --- a/gcloud/alpha/container/fleet/packages/rollouts/describe +++ b/gcloud/alpha/container/fleet/packages/rollouts/describe @@ -43,7 +43,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container fleet packages rollouts describe $ gcloud beta container fleet packages rollouts describe diff --git a/gcloud/alpha/container/fleet/packages/rollouts/help b/gcloud/alpha/container/fleet/packages/rollouts/help index b9401afda..3bbc07ba6 100644 --- a/gcloud/alpha/container/fleet/packages/rollouts/help +++ b/gcloud/alpha/container/fleet/packages/rollouts/help @@ -36,7 +36,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container fleet packages rollouts $ gcloud beta container fleet packages rollouts diff --git a/gcloud/alpha/container/fleet/packages/rollouts/list b/gcloud/alpha/container/fleet/packages/rollouts/list index ae74cda40..302f55885 100644 --- a/gcloud/alpha/container/fleet/packages/rollouts/list +++ b/gcloud/alpha/container/fleet/packages/rollouts/list @@ -73,7 +73,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container fleet packages rollouts list $ gcloud beta container fleet packages rollouts list diff --git a/gcloud/alpha/container/fleet/packages/rollouts/resume b/gcloud/alpha/container/fleet/packages/rollouts/resume index 31425a59d..bd4110a36 100644 --- a/gcloud/alpha/container/fleet/packages/rollouts/resume +++ b/gcloud/alpha/container/fleet/packages/rollouts/resume @@ -70,7 +70,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container fleet packages rollouts resume $ gcloud beta container fleet packages rollouts resume diff --git a/gcloud/alpha/container/fleet/packages/rollouts/suspend b/gcloud/alpha/container/fleet/packages/rollouts/suspend index 39ec85d53..381466c57 100644 --- a/gcloud/alpha/container/fleet/packages/rollouts/suspend +++ b/gcloud/alpha/container/fleet/packages/rollouts/suspend @@ -70,7 +70,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container fleet packages rollouts suspend $ gcloud beta container fleet packages rollouts suspend diff --git a/gcloud/alpha/container/fleet/packages/update b/gcloud/alpha/container/fleet/packages/update index 880c88033..c82e53e68 100644 --- a/gcloud/alpha/container/fleet/packages/update +++ b/gcloud/alpha/container/fleet/packages/update @@ -64,7 +64,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container fleet packages update $ gcloud beta container fleet packages update diff --git a/gcloud/alpha/container/hub/config-management/disable b/gcloud/alpha/container/hub/config-management/disable index b0e82ee26..ec166858b 100644 --- a/gcloud/alpha/container/hub/config-management/disable +++ b/gcloud/alpha/container/hub/config-management/disable @@ -1,40 +1,101 @@ NAME - gcloud alpha container hub config-management disable - disable Config + gcloud alpha container hub config-management disable - disable the Config Management feature SYNOPSIS - gcloud alpha container hub config-management disable - [--fleet-default-member-config | --force] [GCLOUD_WIDE_FLAG ...] + gcloud alpha container hub config-management disable [--force] + [--fleet-default-member-config | --uninstall --all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Disable the Config Management feature in a fleet. Disable the - feature entirely or only disable fleet-default membership configuration - (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features) - for the feature. + (ALPHA) Disable the Config Management feature entirely, or disable specific + configuration on the feature. + + gcloud alpha container hub config-management disable without flags deletes + the Config Management feature, which unmanages and leaves existing Config + Sync installations on membership clusters. Running the command without + flags exits silently if the feature does not exist. Specify flags to + disable configuration on parts of the feature without deleting it. EXAMPLES To disable the Config Management feature entirely, run: $ gcloud alpha container hub config-management disable - To disable only fleet-default membership configuration for the feature, - run: + To unmanage Config Sync only on select memberships, run: $ gcloud alpha container hub config-management disable \ - --fleet-default-member-config + --memberships=example-membership-1,example-membership-2 FLAGS + --force + Force disablement. Bypasses any prompts for confirmation. When + disabling the entire feature, proceeds even if the feature is in use. + Might result in unexpected behavior. + At most one of these can be specified: --fleet-default-member-config Disable the fleet-default membership configuration (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features). - Does not change existing membership configurations. + Does not change existing membership configurations. Does nothing if + the feature is disabled. - --force - Force disablement. Bypasses any prompts for confirmation. When - disabling the entire feature, proceeds even if the feature is in use. - Might result in unexpected behavior. + Membership-specific flags. In the absence of --uninstall, using either + --memberships or --all-memberships removes the entire configuration for + the specified memberships, which unmanages and leaves existing Config + Sync installations on the membership clusters. Unmanagement does not + error if the feature is disabled. + + --uninstall + Uninstall any previously-installed and managed Config Sync on the + specified memberships by setting the enabled field + (https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/reference/gcloud-apply-fields) + to false. Clears all other configuration for each membership. Does + not wait for the uninstallation to complete. To bypass the + confirmation prompt, use --force. Requires the feature to be + enabled. + + To uninstall Config Sync on select memberships, run: + + $ gcloud alpha container hub config-management disable --uninstall \ + --memberships=example-membership-1,example-membership-2 + + At most one of these can be specified: + + --all-memberships + All 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, diff --git a/gcloud/alpha/container/hub/config-management/help b/gcloud/alpha/container/hub/config-management/help index e4cba9c5c..4a7eac93f 100644 --- a/gcloud/alpha/container/hub/config-management/help +++ b/gcloud/alpha/container/hub/config-management/help @@ -27,7 +27,7 @@ COMMANDS given membership. disable - (ALPHA) Disable Config Management feature. + (ALPHA) Disable the Config Management feature. enable (ALPHA) Enable Config Management feature. diff --git a/gcloud/alpha/container/hub/packages/create b/gcloud/alpha/container/hub/packages/create index 6904ea439..c63c33b68 100644 --- a/gcloud/alpha/container/hub/packages/create +++ b/gcloud/alpha/container/hub/packages/create @@ -39,7 +39,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container hub packages create $ gcloud beta container hub packages create diff --git a/gcloud/alpha/container/hub/packages/delete b/gcloud/alpha/container/hub/packages/delete index b38d7009e..f7e3d4bab 100644 --- a/gcloud/alpha/container/hub/packages/delete +++ b/gcloud/alpha/container/hub/packages/delete @@ -64,7 +64,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container hub packages delete $ gcloud beta container hub packages delete diff --git a/gcloud/alpha/container/hub/packages/describe b/gcloud/alpha/container/hub/packages/describe index f59179d0a..fb9629ea2 100644 --- a/gcloud/alpha/container/hub/packages/describe +++ b/gcloud/alpha/container/hub/packages/describe @@ -64,7 +64,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container hub packages describe $ gcloud beta container hub packages describe diff --git a/gcloud/alpha/container/hub/packages/help b/gcloud/alpha/container/hub/packages/help index 0fae34db1..1e7fe4f46 100644 --- a/gcloud/alpha/container/hub/packages/help +++ b/gcloud/alpha/container/hub/packages/help @@ -43,7 +43,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container hub packages $ gcloud beta container hub packages diff --git a/gcloud/alpha/container/hub/packages/list b/gcloud/alpha/container/hub/packages/list index cb7d6b5be..7797e933d 100644 --- a/gcloud/alpha/container/hub/packages/list +++ b/gcloud/alpha/container/hub/packages/list @@ -63,7 +63,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container hub packages list $ gcloud beta container hub packages list diff --git a/gcloud/alpha/container/hub/packages/resource-bundles/create b/gcloud/alpha/container/hub/packages/resource-bundles/create index 2aa3b7232..c39125ed5 100644 --- a/gcloud/alpha/container/hub/packages/resource-bundles/create +++ b/gcloud/alpha/container/hub/packages/resource-bundles/create @@ -39,7 +39,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container hub packages resource-bundles create $ gcloud beta container hub packages resource-bundles create diff --git a/gcloud/alpha/container/hub/packages/resource-bundles/delete b/gcloud/alpha/container/hub/packages/resource-bundles/delete index cf33c6177..60e594c41 100644 --- a/gcloud/alpha/container/hub/packages/resource-bundles/delete +++ b/gcloud/alpha/container/hub/packages/resource-bundles/delete @@ -39,7 +39,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container hub packages resource-bundles delete $ gcloud beta container hub packages resource-bundles delete diff --git a/gcloud/alpha/container/hub/packages/resource-bundles/describe b/gcloud/alpha/container/hub/packages/resource-bundles/describe index 8d545a598..c993eab90 100644 --- a/gcloud/alpha/container/hub/packages/resource-bundles/describe +++ b/gcloud/alpha/container/hub/packages/resource-bundles/describe @@ -35,7 +35,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container hub packages resource-bundles describe $ gcloud beta container hub packages resource-bundles describe diff --git a/gcloud/alpha/container/hub/packages/resource-bundles/help b/gcloud/alpha/container/hub/packages/resource-bundles/help index bbddae506..4bda06fd0 100644 --- a/gcloud/alpha/container/hub/packages/resource-bundles/help +++ b/gcloud/alpha/container/hub/packages/resource-bundles/help @@ -43,7 +43,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container hub packages resource-bundles $ gcloud beta container hub packages resource-bundles diff --git a/gcloud/alpha/container/hub/packages/resource-bundles/list b/gcloud/alpha/container/hub/packages/resource-bundles/list index 3e2a43d1d..fa790902f 100644 --- a/gcloud/alpha/container/hub/packages/resource-bundles/list +++ b/gcloud/alpha/container/hub/packages/resource-bundles/list @@ -65,7 +65,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container hub packages resource-bundles list $ gcloud beta container hub packages resource-bundles list diff --git a/gcloud/alpha/container/hub/packages/resource-bundles/releases/create b/gcloud/alpha/container/hub/packages/resource-bundles/releases/create index d7ab47c38..54e6d5995 100644 --- a/gcloud/alpha/container/hub/packages/resource-bundles/releases/create +++ b/gcloud/alpha/container/hub/packages/resource-bundles/releases/create @@ -69,7 +69,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container hub packages resource-bundles releases create $ gcloud beta container hub packages resource-bundles releases create diff --git a/gcloud/alpha/container/hub/packages/resource-bundles/releases/delete b/gcloud/alpha/container/hub/packages/resource-bundles/releases/delete index 7fde570e5..0d5f5c2e2 100644 --- a/gcloud/alpha/container/hub/packages/resource-bundles/releases/delete +++ b/gcloud/alpha/container/hub/packages/resource-bundles/releases/delete @@ -45,7 +45,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container hub packages resource-bundles releases delete $ gcloud beta container hub packages resource-bundles releases delete diff --git a/gcloud/alpha/container/hub/packages/resource-bundles/releases/describe b/gcloud/alpha/container/hub/packages/resource-bundles/releases/describe index 7d51ad93b..10dfbfcb0 100644 --- a/gcloud/alpha/container/hub/packages/resource-bundles/releases/describe +++ b/gcloud/alpha/container/hub/packages/resource-bundles/releases/describe @@ -41,7 +41,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container hub packages resource-bundles releases describe $ gcloud beta container hub packages resource-bundles releases \ describe diff --git a/gcloud/alpha/container/hub/packages/resource-bundles/releases/help b/gcloud/alpha/container/hub/packages/resource-bundles/releases/help index 6a3d09ab8..2aa92071e 100644 --- a/gcloud/alpha/container/hub/packages/resource-bundles/releases/help +++ b/gcloud/alpha/container/hub/packages/resource-bundles/releases/help @@ -37,7 +37,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container hub packages resource-bundles releases $ gcloud beta container hub packages resource-bundles releases diff --git a/gcloud/alpha/container/hub/packages/resource-bundles/releases/list b/gcloud/alpha/container/hub/packages/resource-bundles/releases/list index a3623ccea..e3ba9d970 100644 --- a/gcloud/alpha/container/hub/packages/resource-bundles/releases/list +++ b/gcloud/alpha/container/hub/packages/resource-bundles/releases/list @@ -69,7 +69,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container hub packages resource-bundles releases list $ gcloud beta container hub packages resource-bundles releases list diff --git a/gcloud/alpha/container/hub/packages/resource-bundles/releases/update b/gcloud/alpha/container/hub/packages/resource-bundles/releases/update index e4c5df912..40ea89937 100644 --- a/gcloud/alpha/container/hub/packages/resource-bundles/releases/update +++ b/gcloud/alpha/container/hub/packages/resource-bundles/releases/update @@ -44,7 +44,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container hub packages resource-bundles releases update $ gcloud beta container hub packages resource-bundles releases update diff --git a/gcloud/alpha/container/hub/packages/resource-bundles/update b/gcloud/alpha/container/hub/packages/resource-bundles/update index af1876328..9005bd28a 100644 --- a/gcloud/alpha/container/hub/packages/resource-bundles/update +++ b/gcloud/alpha/container/hub/packages/resource-bundles/update @@ -39,7 +39,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container hub packages resource-bundles update $ gcloud beta container hub packages resource-bundles update diff --git a/gcloud/alpha/container/hub/packages/rollouts/abort b/gcloud/alpha/container/hub/packages/rollouts/abort index 99b667c02..0c7c0e7e4 100644 --- a/gcloud/alpha/container/hub/packages/rollouts/abort +++ b/gcloud/alpha/container/hub/packages/rollouts/abort @@ -69,7 +69,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container hub packages rollouts abort $ gcloud beta container hub packages rollouts abort diff --git a/gcloud/alpha/container/hub/packages/rollouts/describe b/gcloud/alpha/container/hub/packages/rollouts/describe index 7717f32d2..a6b514320 100644 --- a/gcloud/alpha/container/hub/packages/rollouts/describe +++ b/gcloud/alpha/container/hub/packages/rollouts/describe @@ -43,7 +43,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container hub packages rollouts describe $ gcloud beta container hub packages rollouts describe diff --git a/gcloud/alpha/container/hub/packages/rollouts/help b/gcloud/alpha/container/hub/packages/rollouts/help index 3941da8ff..7a71db341 100644 --- a/gcloud/alpha/container/hub/packages/rollouts/help +++ b/gcloud/alpha/container/hub/packages/rollouts/help @@ -35,7 +35,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container hub packages rollouts $ gcloud beta container hub packages rollouts diff --git a/gcloud/alpha/container/hub/packages/rollouts/list b/gcloud/alpha/container/hub/packages/rollouts/list index 488f75f97..1998e56a1 100644 --- a/gcloud/alpha/container/hub/packages/rollouts/list +++ b/gcloud/alpha/container/hub/packages/rollouts/list @@ -73,7 +73,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container hub packages rollouts list $ gcloud beta container hub packages rollouts list diff --git a/gcloud/alpha/container/hub/packages/rollouts/resume b/gcloud/alpha/container/hub/packages/rollouts/resume index eb22b3cb3..58448ed2c 100644 --- a/gcloud/alpha/container/hub/packages/rollouts/resume +++ b/gcloud/alpha/container/hub/packages/rollouts/resume @@ -70,7 +70,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container hub packages rollouts resume $ gcloud beta container hub packages rollouts resume diff --git a/gcloud/alpha/container/hub/packages/rollouts/suspend b/gcloud/alpha/container/hub/packages/rollouts/suspend index f9b2449f5..2d9859683 100644 --- a/gcloud/alpha/container/hub/packages/rollouts/suspend +++ b/gcloud/alpha/container/hub/packages/rollouts/suspend @@ -70,7 +70,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container hub packages rollouts suspend $ gcloud beta container hub packages rollouts suspend diff --git a/gcloud/alpha/container/hub/packages/update b/gcloud/alpha/container/hub/packages/update index 781368168..7cd99ea17 100644 --- a/gcloud/alpha/container/hub/packages/update +++ b/gcloud/alpha/container/hub/packages/update @@ -64,7 +64,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container hub packages update $ gcloud beta container hub packages update diff --git a/gcloud/alpha/dataplex/datascans/create/data-quality b/gcloud/alpha/dataplex/datascans/create/data-quality index 27569d8b9..010f0c353 100644 --- a/gcloud/alpha/dataplex/datascans/create/data-quality +++ b/gcloud/alpha/dataplex/datascans/create/data-quality @@ -65,9 +65,11 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --data-quality-spec-file=DATA_QUALITY_SPEC_FILE - path to the JSON/YAML file containing the spec for the data quality - scan. The json representation reference: + Path to the JSON/YAML file containing the spec for the data quality + scan. The JSON representation reference: https://cloud.google.com/dataplex/docs/reference/rest/v1/DataQualitySpec + The YAML representation reference: + https://cloud.google.com/dataplex/docs/use-auto-data-quality#create-scan-using-gcloud Data source for the data quality scan. diff --git a/gcloud/alpha/dataplex/datascans/update/data-quality b/gcloud/alpha/dataplex/datascans/update/data-quality index b76b6e08f..c7db84d45 100644 --- a/gcloud/alpha/dataplex/datascans/update/data-quality +++ b/gcloud/alpha/dataplex/datascans/update/data-quality @@ -58,9 +58,11 @@ POSITIONAL ARGUMENTS FLAGS --data-quality-spec-file=DATA_QUALITY_SPEC_FILE - path to the JSON/YAML file containing the spec for the data quality - scan. The json representation reference: + Path to the JSON/YAML file containing the spec for the data quality + scan. The JSON representation reference: https://cloud.google.com/dataplex/docs/reference/rest/v1/DataQualitySpec + The YAML representation reference: + https://cloud.google.com/dataplex/docs/use-auto-data-quality#create-scan-using-gcloud --description=DESCRIPTION Description of the data quality scan diff --git a/gcloud/alpha/managed-kafka/acls/list b/gcloud/alpha/managed-kafka/acls/list index 6adeef965..6ad921042 100644 --- a/gcloud/alpha/managed-kafka/acls/list +++ b/gcloud/alpha/managed-kafka/acls/list @@ -4,8 +4,8 @@ NAME SYNOPSIS gcloud alpha managed-kafka acls list (CLUSTER : --location=LOCATION) - [--filter=EXPRESSION] [--limit=LIMIT] [--sort-by=[FIELD,...]] - [GCLOUD_WIDE_FLAG ...] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) List all Managed Service for Apache Kafka acls in a given cluster. @@ -65,6 +65,13 @@ LIST COMMAND FLAGS 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 diff --git a/gcloud/alpha/managed-kafka/clusters/update b/gcloud/alpha/managed-kafka/clusters/update index dc9bbaf7b..65bfa6737 100644 --- a/gcloud/alpha/managed-kafka/clusters/update +++ b/gcloud/alpha/managed-kafka/clusters/update @@ -7,7 +7,8 @@ SYNOPSIS (--auto-rebalance --cpu=CPU --labels=[KEY=VALUE,...] --memory=MEMORY --ssl-principal-mapping-rules=SSL_PRINCIPAL_MAPPING_RULES --subnets=[SUBNETS,...] --clear-mtls-ca-pools - | --mtls-ca-pools=[MTLS_CA_POOLS,...]) [--async] + | --mtls-ca-pools=[MTLS_CA_POOLS,...]) + [--allow-broker-downscale-on-cluster-upscale] [--async] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -117,6 +118,13 @@ REQUIRED FLAGS CA pools using the --clear-mtls-ca-pools flag. OPTIONAL FLAGS + --allow-broker-downscale-on-cluster-upscale + If enabled, this setting allows an update operation that could + significantly decrease the per-broker vCPU and/or memory allocation, + which can lead to reduced performance and availability. By default, an + update operation will fail if it results in a reduction of 10% or more + to the brokers' vCPU or memory allocation. + --async Return immediately, without waiting for the operation in progress to complete. diff --git a/gcloud/alpha/ml-engine/explain b/gcloud/alpha/ml-engine/explain deleted file mode 100644 index baf2a59e4..000000000 --- a/gcloud/alpha/ml-engine/explain +++ /dev/null @@ -1,104 +0,0 @@ -NAME - gcloud alpha ml-engine explain - run AI Platform explanation - -SYNOPSIS - gcloud alpha ml-engine explain --model=MODEL - (--json-instances=JSON_INSTANCES | --json-request=JSON_REQUEST - | --text-instances=TEXT_INSTANCES) [--region=REGION] - [--version=VERSION] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) gcloud alpha ml-engine explain sends an explain request to AI - Platform for the given instances. This command will read up to 100 - instances, though the service itself will accept instances up to the - payload limit size (currently, 1.5MB). - -EXAMPLES - To get explanations for an AI Platform version model with the version - 'version' and with the name 'model-name', run: - - $ gcloud alpha ml-engine explain explain --model=model-name \ - --version=version --json-instances=instances.json - -REQUIRED FLAGS - --model=MODEL - Name of the model. - - Exactly one of these must be specified: - - --json-instances=JSON_INSTANCES - Path to a local file from which instances are read. Instances are in - JSON format; newline delimited. - - An example of the JSON instances file: - - {"images": [0.0, ..., 0.1], "key": 3} - {"images": [0.0, ..., 0.1], "key": 2} - ... - - This flag accepts "-" for stdin. - - --json-request=JSON_REQUEST - Path to a local file containing the body of JSON request. - - An example of a JSON request: - - { - "instances": [ - {"x": [1, 2], "y": [3, 4]}, - {"x": [-1, -2], "y": [-3, -4]} - ] - } - - This flag accepts "-" for stdin. - - --text-instances=TEXT_INSTANCES - Path to a local file from which instances are read. Instances are in - UTF-8 encoded text format; newline delimited. - - An example of the text instances file: - - 107,4.9,2.5,4.5,1.7 - 100,5.7,2.8,4.1,1.3 - ... - - This flag accepts "-" for stdin. - -OPTIONAL FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - - --version=VERSION - Model version to be used. - - If unspecified, the default version of the model will be used. To list - model versions run - - $ gcloud alpha ml-engine versions list - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -NOTES - This command is currently in alpha and might change without notice. If this - command fails with API permission errors despite specifying the correct - project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: - - $ gcloud beta ml-engine explain - diff --git a/gcloud/alpha/ml-engine/help b/gcloud/alpha/ml-engine/help deleted file mode 100644 index 19a8d2944..000000000 --- a/gcloud/alpha/ml-engine/help +++ /dev/null @@ -1,64 +0,0 @@ -NAME - gcloud alpha ml-engine - manage AI Platform jobs and models - -SYNOPSIS - gcloud alpha ml-engine GROUP | COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) The gcloud alpha ml-engine command group lets you manage AI - Platform jobs and training models. - - AI Platform is a managed service that enables you to easily build machine - learning models, that work on any type of data, of any size. Create your - model with the powerful TensorFlow framework that powers many Google - products, from Google Photos to Google Cloud Speech. - - More information on AI Platform can be found here: - https://cloud.google.com/ml and detailed documentation can be found here: - https://cloud.google.com/ml/docs/ - -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) AI Platform Jobs commands. - - local - (ALPHA) AI Platform Local commands. - - locations - (ALPHA) Query AI Platform location capabilities. - - models - (ALPHA) AI Platform Models commands. - - operations - (ALPHA) Manage AI Platform operations. - - versions - (ALPHA) AI Platform Versions commands. - -COMMANDS - COMMAND is one of the following: - - explain - (ALPHA) Run AI Platform explanation. - - predict - (ALPHA) Run AI Platform online prediction. - -NOTES - This command is currently in alpha and might change without notice. If this - command fails 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 ml-engine - - $ gcloud beta ml-engine - diff --git a/gcloud/alpha/ml-engine/jobs/cancel b/gcloud/alpha/ml-engine/jobs/cancel deleted file mode 100644 index fd5d12763..000000000 --- a/gcloud/alpha/ml-engine/jobs/cancel +++ /dev/null @@ -1,33 +0,0 @@ -NAME - gcloud alpha ml-engine jobs cancel - cancel a running AI Platform job - -SYNOPSIS - gcloud alpha ml-engine jobs cancel JOB [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) gcloud alpha ml-engine jobs cancel cancels a running AI Platform - job. If the job is already finished, the command will not perform an - operation and exit successfully. - -POSITIONAL ARGUMENTS - JOB - Name of the job. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine jobs cancel - - $ gcloud beta ml-engine jobs cancel - diff --git a/gcloud/alpha/ml-engine/jobs/describe b/gcloud/alpha/ml-engine/jobs/describe deleted file mode 100644 index df50e6c37..000000000 --- a/gcloud/alpha/ml-engine/jobs/describe +++ /dev/null @@ -1,59 +0,0 @@ -NAME - gcloud alpha ml-engine jobs describe - describe an AI Platform job - -SYNOPSIS - gcloud alpha ml-engine jobs describe JOB [--summarize] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Describe an AI Platform job. - -EXAMPLES - To describe the AI Platform job named my-job, run: - - gcloud alpha ml-engine jobs describe my-job - -POSITIONAL ARGUMENTS - JOB - Name of the job. - -FLAGS - --summarize - Summarize job output in a set of human readable tables instead of - rendering the entire resource as json or yaml. The tables currently - rendered are: - - ◆ Job Overview: Overview of job including, jobId, status and create - time. - ◆ Training Input Summary: Summary of input for a training job - including region, main training python module and scale tier. - ◆ Training Output Summary: Summary of output for a training job - including the amount of ML units consumed by the job. - ◆ Training Output Trials: Summary of hyperparameter trials run for a - hyperparameter tuning training job. - ◆ Predict Input Summary: Summary of input for a prediction job - including region, model verion and output path. - ◆ Predict Output Summary: Summary of output for a prediction job - including prediction count and output path. - - This flag overrides the --format flag. If both are present on the - command line, a warning is displayed. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine jobs describe - - $ gcloud beta ml-engine jobs describe - diff --git a/gcloud/alpha/ml-engine/jobs/help b/gcloud/alpha/ml-engine/jobs/help deleted file mode 100644 index 96f5ca5e1..000000000 --- a/gcloud/alpha/ml-engine/jobs/help +++ /dev/null @@ -1,48 +0,0 @@ -NAME - gcloud alpha ml-engine jobs - AI Platform Jobs commands - -SYNOPSIS - gcloud alpha ml-engine jobs GROUP | COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) AI Platform Jobs commands. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -GROUPS - GROUP is one of the following: - - submit - (ALPHA) AI Platform Jobs submit commands. - -COMMANDS - COMMAND is one of the following: - - cancel - (ALPHA) Cancel a running AI Platform job. - - describe - (ALPHA) Describe an AI Platform job. - - list - (ALPHA) List existing AI Platform jobs. - - stream-logs - (ALPHA) Show logs from a running AI Platform job. - - update - (ALPHA) Update an AI Platform job. - -NOTES - This command is currently in alpha and might change without notice. If this - command fails 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 ml-engine jobs - - $ gcloud beta ml-engine jobs - diff --git a/gcloud/alpha/ml-engine/jobs/stream-logs b/gcloud/alpha/ml-engine/jobs/stream-logs deleted file mode 100644 index e70109891..000000000 --- a/gcloud/alpha/ml-engine/jobs/stream-logs +++ /dev/null @@ -1,51 +0,0 @@ -NAME - gcloud alpha ml-engine jobs stream-logs - show logs from a running AI - Platform job - -SYNOPSIS - gcloud alpha ml-engine jobs stream-logs JOB [--allow-multiline-logs] - [--polling-interval=POLLING_INTERVAL; default=60] - [--task-name=TASK_NAME] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Show logs from a running AI Platform job. - -EXAMPLES - To show the logs from running the AI Platform job my-job, run: - - $ gcloud alpha ml-engine jobs stream-logs my-job - -POSITIONAL ARGUMENTS - JOB - Name of the job. - -FLAGS - --allow-multiline-logs - Output multiline log messages as single records. - - --polling-interval=POLLING_INTERVAL; default=60 - Number of seconds to wait between efforts to fetch the latest log - messages. Overrides the default ml_engine/polling_interval property - value for this command invocation. - - --task-name=TASK_NAME - If set, display only the logs for this particular task. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine jobs stream-logs - - $ gcloud beta ml-engine jobs stream-logs - diff --git a/gcloud/alpha/ml-engine/jobs/submit/help b/gcloud/alpha/ml-engine/jobs/submit/help deleted file mode 100644 index 8dbb0dfc7..000000000 --- a/gcloud/alpha/ml-engine/jobs/submit/help +++ /dev/null @@ -1,33 +0,0 @@ -NAME - gcloud alpha ml-engine jobs submit - AI Platform Jobs submit commands - -SYNOPSIS - gcloud alpha ml-engine jobs submit COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) AI Platform Jobs submit commands. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -COMMANDS - COMMAND is one of the following: - - prediction - (ALPHA) Start an AI Platform batch prediction job. - - training - (ALPHA) Submit an AI Platform training job. - -NOTES - This command is currently in alpha and might change without notice. If this - command fails 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 ml-engine jobs submit - - $ gcloud beta ml-engine jobs submit - diff --git a/gcloud/alpha/ml-engine/jobs/submit/prediction b/gcloud/alpha/ml-engine/jobs/submit/prediction deleted file mode 100644 index ccca9ecbc..000000000 --- a/gcloud/alpha/ml-engine/jobs/submit/prediction +++ /dev/null @@ -1,144 +0,0 @@ -NAME - gcloud alpha ml-engine jobs submit prediction - start an AI Platform batch - prediction job - -SYNOPSIS - gcloud alpha ml-engine jobs submit prediction JOB --data-format=DATA_FORMAT - --input-paths=INPUT_PATH,[INPUT_PATH,...] --output-path=OUTPUT_PATH - --region=REGION (--model=MODEL | --model-dir=MODEL_DIR) - [--batch-size=BATCH_SIZE] [--labels=[KEY=VALUE,...]] - [--max-worker-count=MAX_WORKER_COUNT] - [--runtime-version=RUNTIME_VERSION] [--signature-name=SIGNATURE_NAME] - [--version=VERSION] - [--accelerator-count=ACCELERATOR_COUNT - --accelerator-type=ACCELERATOR_TYPE] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Start an AI Platform batch prediction job. - -POSITIONAL ARGUMENTS - JOB - Name of the batch prediction job. - -REQUIRED FLAGS - --data-format=DATA_FORMAT - Data format of the input files. DATA_FORMAT must be one of: - - text - Text and JSON files; for text files, see - https://www.tensorflow.org/guide/datasets#consuming_text_data, for - JSON files, see - https://cloud.google.com/ai-platform/prediction/docs/overview#batch_prediction_input_data - tf-record - TFRecord files; see - https://www.tensorflow.org/guide/datasets#consuming_tfrecord_data - tf-record-gzip - GZIP-compressed TFRecord files. - - --input-paths=INPUT_PATH,[INPUT_PATH,...] - Cloud Storage paths to the instances to run prediction on. - - Wildcards (*) accepted at the end of a path. More than one path can be - specified if multiple file patterns are needed. For example, - - gs://my-bucket/instances*,gs://my-bucket/other-instances1 - - will match any objects whose names start with instances in my-bucket as - well as the other-instances1 bucket, while - - gs://my-bucket/instance-dir/* - - will match any objects in the instance-dir "directory" (since - directories aren't a first-class Cloud Storage concept) of my-bucket. - - --output-path=OUTPUT_PATH - Cloud Storage path to which to save the output. Example: - gs://my-bucket/output. - - --region=REGION - The Compute Engine region to run the job in. - - Exactly one of these must be specified: - - --model=MODEL - Name of the model to use for prediction. - - --model-dir=MODEL_DIR - Cloud Storage location where the model files are located. - -OPTIONAL FLAGS - --batch-size=BATCH_SIZE - The number of records per batch. The service will buffer batch_size - number of records in memory before invoking TensorFlow. Defaults to 64 - if not specified. - - --labels=[KEY=VALUE,...] - List of label KEY=VALUE pairs to add. - - Keys must start with a lowercase character and contain only hyphens - (-), underscores (_), lowercase characters, and numbers. Values must - contain only hyphens (-), underscores (_), lowercase characters, and - numbers. - - --max-worker-count=MAX_WORKER_COUNT - The maximum number of workers to be used for parallel processing. - Defaults to 10 if not specified. - - --runtime-version=RUNTIME_VERSION - AI Platform runtime version for this job. Must be specified unless - --master-image-uri is specified instead. It is defined in documentation - along with the list of supported versions: - https://cloud.google.com/ai-platform/prediction/docs/runtime-version-list - - --signature-name=SIGNATURE_NAME - Name of the signature defined in the SavedModel to use for this job. - Defaults to DEFAULT_SERVING_SIGNATURE_DEF_KEY in - https://www.tensorflow.org/api_docs/python/tf/compat/v1/saved_model/signature_constants, - which is "serving_default". Only applies to TensorFlow models. - - --version=VERSION - Model version to be used. - - This flag may only be given if --model is specified. If unspecified, - the default version of the model will be used. To list versions for a - model, run - - $ gcloud ai-platform versions list - - Accelerator Configuration. - - --accelerator-count=ACCELERATOR_COUNT - The number of accelerators to attach to the machines. Must be >= 1. - - This flag argument must be specified if any of the other arguments in - this group are specified. - - --accelerator-type=ACCELERATOR_TYPE - The available types of accelerators. ACCELERATOR_TYPE must be one of: - - nvidia-tesla-k80 - NVIDIA Tesla K80 GPU - nvidia-tesla-p100 - NVIDIA Tesla P100 GPU. - - This flag argument must be specified if any of the other arguments in - this group are specified. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine jobs submit prediction - - $ gcloud beta ml-engine jobs submit prediction - diff --git a/gcloud/alpha/ml-engine/jobs/submit/training b/gcloud/alpha/ml-engine/jobs/submit/training deleted file mode 100644 index 282db4c1b..000000000 --- a/gcloud/alpha/ml-engine/jobs/submit/training +++ /dev/null @@ -1,439 +0,0 @@ -NAME - gcloud alpha ml-engine jobs submit training - submit an AI Platform - training job - -SYNOPSIS - gcloud alpha ml-engine jobs submit training JOB [--config=CONFIG] - [--enable-web-access] [--job-dir=JOB_DIR] [--labels=[KEY=VALUE,...]] - [--master-accelerator=[count=COUNT],[type=TYPE]] - [--master-image-uri=MASTER_IMAGE_URI] - [--master-machine-type=MASTER_MACHINE_TYPE] [--module-name=MODULE_NAME] - [--network=NETWORK] [--package-path=PACKAGE_PATH] - [--packages=[PACKAGE,...]] - [--parameter-server-accelerator=[count=COUNT],[type=TYPE]] - [--parameter-server-image-uri=PARAMETER_SERVER_IMAGE_URI] - [--python-version=PYTHON_VERSION] [--region=REGION] - [--runtime-version=RUNTIME_VERSION] [--scale-tier=SCALE_TIER] - [--service-account=SERVICE_ACCOUNT] [--staging-bucket=STAGING_BUCKET] - [--tpu-tf-version=TPU_TF_VERSION] - [--use-chief-in-tf-config=USE_CHIEF_IN_TF_CONFIG] - [--worker-accelerator=[count=COUNT],[type=TYPE]] - [--worker-image-uri=WORKER_IMAGE_URI] [--async | --stream-logs] - [--kms-key=KMS_KEY : --kms-keyring=KMS_KEYRING - --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT] - [--parameter-server-count=PARAMETER_SERVER_COUNT - --parameter-server-machine-type=PARAMETER_SERVER_MACHINE_TYPE] - [--worker-count=WORKER_COUNT --worker-machine-type=WORKER_MACHINE_TYPE] - [GCLOUD_WIDE_FLAG ...] [-- USER_ARGS ...] - -DESCRIPTION - (ALPHA) Submit an AI Platform training job. - - This creates temporary files and executes Python code staged by a user on - Cloud Storage. Model code can either be specified with a path, e.g.: - - $ gcloud alpha ml-engine jobs submit training my_job \ - --module-name trainer.task \ - --staging-bucket gs://my-bucket \ - --package-path /my/code/path/trainer \ - --packages additional-dep1.tar.gz,dep2.whl - - Or by specifying an already built package: - - $ gcloud alpha ml-engine jobs submit training my_job \ - --module-name trainer.task \ - --staging-bucket gs://my-bucket \ - --packages trainer-0.0.1.tar.gz,additional-dep1.tar.gz,dep2.whl - - If --package-path=/my/code/path/trainer is specified and there is a - setup.py file at /my/code/path/setup.py, the setup file will be invoked - with sdist and the generated tar files will be uploaded to Cloud Storage. - Otherwise, a temporary setup.py file will be generated for the build. - - By default, this command runs asynchronously; it exits once the job is - successfully submitted. - - To follow the progress of your job, pass the --stream-logs flag (note that - even with the --stream-logs flag, the job will continue to run after this - command exits and must be cancelled with gcloud ai-platform jobs cancel - JOB_ID). - - For more information, see: - https://cloud.google.com/ai-platform/training/docs/overview - -POSITIONAL ARGUMENTS - JOB - Name of the job. - - [-- USER_ARGS ...] - Additional user arguments to be forwarded to user code - - The '--' argument must be specified between gcloud specific args on the - left and USER_ARGS on the right. - -FLAGS - --config=CONFIG - Path to the job configuration file. This file should be a YAML document - (JSON also accepted) containing a Job resource as defined in the API - (all fields are optional): - https://cloud.google.com/ml/reference/rest/v1/projects.jobs - - EXAMPLES: - - JSON: - - { - "jobId": "my_job", - "labels": { - "type": "prod", - "owner": "alice" - }, - "trainingInput": { - "scaleTier": "BASIC", - "packageUris": [ - "gs://my/package/path" - ], - "region": "us-east1" - } - } - - YAML: - - jobId: my_job - labels: - type: prod - owner: alice - trainingInput: - scaleTier: BASIC - packageUris: - - gs://my/package/path - region: us-east1 - - If an option is specified both in the configuration file **and** via - command line arguments, the command line arguments override the - configuration file. - - --enable-web-access - Whether you want AI Platform Training to enable [interactive shell - access] - (https://cloud.google.com/ai-platform/training/docs/monitor-debug-interactive-shell) - to training containers. If set to true, you can access interactive - shells at the URIs given by TrainingOutput.web_access_uris or - HyperparameterOutput.web_access_uris (within TrainingOutput.trials). - - --job-dir=JOB_DIR - Cloud Storage path in which to store training outputs and other data - needed for training. - - This path will be passed to your TensorFlow program as the --job-dir - command-line arg. The benefit of specifying this field is that AI - Platform will validate the path for use in training. However, note that - your training program will need to parse the provided --job-dir - argument. - - If packages must be uploaded and --staging-bucket is not provided, this - path will be used instead. - - --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. - - --master-accelerator=[count=COUNT],[type=TYPE] - Hardware accelerator config for the master worker. Must specify both - the accelerator type (TYPE) for each server and the number of - accelerators to attach to each server (COUNT). - - type - Type of the accelerator. Choices are - nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4-pod - - count - Number of accelerators to attach to each machine running the job. - Must be greater than 0. - - --master-image-uri=MASTER_IMAGE_URI - Docker image to run on each master worker. This image must be in - Container Registry. Only one of --master-image-uri and - --runtime-version must be specified. - - --master-machine-type=MASTER_MACHINE_TYPE - Specifies the type of virtual machine to use for training job's master - worker. - - You must set this value when --scale-tier is set to CUSTOM. - - --module-name=MODULE_NAME - Name of the module to run. - - --network=NETWORK - Full name of the Google Compute Engine network - (https://cloud.google.com/vpc/docs) to which the Job is peered with. - For example, projects/12345/global/networks/myVPC. The format is of the - form projects/{project}/global/networks/{network}, where {project} is a - project number, as in '12345', and {network} is network name. Private - services access must already have been configured - (https://cloud.google.com/vpc/docs/configure-private-services-access) - for the network. If unspecified, the Job is not peered with any - network. - - --package-path=PACKAGE_PATH - Path to a Python package to build. This should point to a local - directory containing the Python source for the job. It will be built - using setuptools (which must be installed) using its parent directory - as context. If the parent directory contains a setup.py file, the build - will use that; otherwise, it will use a simple built-in one. - - --packages=[PACKAGE,...] - Path to Python archives used for training. These can be local paths - (absolute or relative), in which case they will be uploaded to the - Cloud Storage bucket given by --staging-bucket, or Cloud Storage URLs - ('gs://bucket-name/path/to/package.tar.gz'). - - --parameter-server-accelerator=[count=COUNT],[type=TYPE] - Hardware accelerator config for the parameter servers. Must specify - both the accelerator type (TYPE) for each server and the number of - accelerators to attach to each server (COUNT). - - type - Type of the accelerator. Choices are - nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4-pod - - count - Number of accelerators to attach to each machine running the job. - Must be greater than 0. - - --parameter-server-image-uri=PARAMETER_SERVER_IMAGE_URI - Docker image to run on each parameter server. This image must be in - Container Registry. If not specified, the value of --master-image-uri - is used. - - --python-version=PYTHON_VERSION - Version of Python used during training. Choices are 3.7, 3.5, and 2.7. - However, this value must be compatible with the chosen runtime version - for the job. - - Must be used with a compatible runtime version: - - ◆ 3.7 is compatible with runtime versions 1.15 and later. - ◆ 3.5 is compatible with runtime versions 1.4 through 1.14. - ◆ 2.7 is compatible with runtime versions 1.15 and earlier. - - --region=REGION - Region of the machine learning training job to submit. If not - specified, you might be prompted to select a region (interactive mode - only). - - To avoid prompting when this flag is omitted, you can set the - compute/region property: - - $ gcloud config set compute/region REGION - - A list of regions can be fetched by running: - - $ gcloud compute regions list - - To unset the property, run: - - $ gcloud config unset compute/region - - Alternatively, the region can be stored in the environment variable - CLOUDSDK_COMPUTE_REGION. - - --runtime-version=RUNTIME_VERSION - AI Platform runtime version for this job. Must be specified unless - --master-image-uri is specified instead. It is defined in documentation - along with the list of supported versions: - https://cloud.google.com/ai-platform/prediction/docs/runtime-version-list - - --scale-tier=SCALE_TIER - Specify the machine types, the number of replicas for workers, and - parameter servers. SCALE_TIER must be one of: - - basic - Single worker instance. This tier is suitable for learning how to - use AI Platform, and for experimenting with new models using small - datasets. - basic-gpu - Single worker instance with a GPU. - basic-tpu - Single worker instance with a Cloud TPU. - custom - CUSTOM tier is not a set tier, but rather enables you to use your - own cluster specification. When you use this tier, set values to - configure your processing cluster according to these guidelines - (using the --config flag): - - ▸ You must set TrainingInput.masterType to specify the type of - machine to use for your master node. This is the only required - setting. - ▸ You may set TrainingInput.workerCount to specify the number of - workers to use. If you specify one or more workers, you must also - set TrainingInput.workerType to specify the type of machine to - use for your worker nodes. - ▸ You may set TrainingInput.parameterServerCount to specify the - number of parameter servers to use. If you specify one or more - parameter servers, you must also set - TrainingInput.parameterServerType to specify the type of machine - to use for your parameter servers. Note that all of your workers - must use the same machine type, which can be different from your - parameter server type and master type. Your parameter servers - must likewise use the same machine type, which can be different - from your worker type and master type. - premium-1 - Large number of workers with many parameter servers. - standard-1 - Many workers and a few parameter servers. - - --service-account=SERVICE_ACCOUNT - The email address of a service account to use when running the training - appplication. You must have the iam.serviceAccounts.actAs permission - for the specified service account. In addition, the AI Platform - Training Google-managed service account must have the - roles/iam.serviceAccountAdmin role for the specified service account. - Learn more about configuring a service account. - (https://cloud.google.com/ai-platform/training/docs/custom-service-account) - If not specified, the AI Platform Training Google-managed service - account is used by default. - - --staging-bucket=STAGING_BUCKET - Bucket in which to stage training archives. - - Required only if a file upload is necessary (that is, other flags - include local paths) and no other flags implicitly specify an upload - path. - - --tpu-tf-version=TPU_TF_VERSION - Runtime version of TensorFlow used by the container. This field must be - specified if a custom container on the TPU worker is being used. - - --use-chief-in-tf-config=USE_CHIEF_IN_TF_CONFIG - Use "chief" role in the cluster instead of "master". This is required - for TensorFlow 2.0 and newer versions. Unlike "master" node, "chief" - node does not run evaluation. - - --worker-accelerator=[count=COUNT],[type=TYPE] - Hardware accelerator config for the worker nodes. Must specify both the - accelerator type (TYPE) for each server and the number of accelerators - to attach to each server (COUNT). - - type - Type of the accelerator. Choices are - nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4-pod - - count - Number of accelerators to attach to each machine running the job. - Must be greater than 0. - - --worker-image-uri=WORKER_IMAGE_URI - Docker image to run on each worker node. This image must be in - Container Registry. If not specified, the value of --master-image-uri - is used. - - At most one of these can be specified: - - --async - (DEPRECATED) Display information about the operation in progress - without waiting for the operation to complete. Enabled by default and - can be omitted; use --stream-logs to run synchronously. - - --stream-logs - Block until job completion and stream the logs while the job runs. - - Note that even if command execution is halted, the job will still run - until cancelled with - - $ gcloud ai-platform jobs cancel JOB_ID - - Key resource - The Cloud KMS (Key Management Service) cryptokey that will - be used to protect the job. The 'AI Platform Service Agent' service - account must hold permission 'Cloud KMS CryptoKey Encrypter/Decrypter'. - The arguments in this group can be used to specify the attributes of this - resource. - - --kms-key=KMS_KEY - ID of the key or fully qualified identifier for the key. - - To set the kms-key attribute: - ▸ provide the argument --kms-key on the command line. - - This flag argument must be specified if any of the other arguments in - this group are specified. - - --kms-keyring=KMS_KEYRING - The KMS keyring of the key. - - To set the kms-keyring attribute: - ▸ provide the argument --kms-key on the command line with a fully - specified name; - ▸ provide the argument --kms-keyring on the command line. - - --kms-location=KMS_LOCATION - The Google Cloud location for the key. - - To set the kms-location attribute: - ▸ provide the argument --kms-key on the command line with a fully - specified name; - ▸ provide the argument --kms-location on the command line. - - --kms-project=KMS_PROJECT - The Google Cloud project for the key. - - To set the kms-project attribute: - ▸ provide the argument --kms-key on the command line with a fully - specified name; - ▸ provide the argument --kms-project on the command line; - ▸ set the property core/project. - - Configure parameter server machine type settings. - - --parameter-server-count=PARAMETER_SERVER_COUNT - Number of parameter servers to use for the training job. - - This flag argument must be specified if any of the other arguments in - this group are specified. - - --parameter-server-machine-type=PARAMETER_SERVER_MACHINE_TYPE - Type of virtual machine to use for training job's parameter servers. - This flag must be specified if any of the other arguments in this - group are specified machine to use for training job's parameter - servers. - - This flag argument must be specified if any of the other arguments in - this group are specified. - - Configure worker node machine type settings. - - --worker-count=WORKER_COUNT - Number of worker nodes to use for the training job. - - This flag argument must be specified if any of the other arguments in - this group are specified. - - --worker-machine-type=WORKER_MACHINE_TYPE - Type of virtual machine to use for training job's worker nodes. - - This flag argument must be specified if any of the other arguments in - this group are specified. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine jobs submit training - - $ gcloud beta ml-engine jobs submit training - diff --git a/gcloud/alpha/ml-engine/jobs/update b/gcloud/alpha/ml-engine/jobs/update deleted file mode 100644 index eb721e8b4..000000000 --- a/gcloud/alpha/ml-engine/jobs/update +++ /dev/null @@ -1,67 +0,0 @@ -NAME - gcloud alpha ml-engine jobs update - update an AI Platform job - -SYNOPSIS - gcloud alpha ml-engine jobs update JOB [--update-labels=[KEY=VALUE,...]] - [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Update an AI Platform job. - -EXAMPLES - To remove all labels in the AI Platform job named my-job, run: - - $ gcloud alpha ml-engine jobs update my-job --clear-labels - -POSITIONAL ARGUMENTS - JOB - Name of the job. - -FLAGS - --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 ml-engine jobs update --clear-labels - - To remove all existing labels and create two new labels, foo and baz: - - $ gcloud alpha ml-engine jobs update --clear-labels \ - --update-labels foo=bar,baz=qux - - --remove-labels=[KEY,...] - List of label keys to remove. If a label does not exist it is - silently ignored. If --update-labels is also specified then - --update-labels is applied first. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -NOTES - This command is currently in alpha and might change without notice. If this - command fails with API permission errors despite specifying the correct - project, you might be trying to access an API with an invitation-only early - access allowlist. These variants are also available: - - $ gcloud ml-engine jobs update - - $ gcloud beta ml-engine jobs update - diff --git a/gcloud/alpha/ml-engine/local/help b/gcloud/alpha/ml-engine/local/help deleted file mode 100644 index 182f2a814..000000000 --- a/gcloud/alpha/ml-engine/local/help +++ /dev/null @@ -1,33 +0,0 @@ -NAME - gcloud alpha ml-engine local - AI Platform Local commands - -SYNOPSIS - gcloud alpha ml-engine local COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) AI Platform Local commands. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -COMMANDS - COMMAND is one of the following: - - predict - (ALPHA) Run prediction locally. - - train - (ALPHA) Run an AI Platform training job locally. - -NOTES - This command is currently in alpha and might change without notice. If this - command fails 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 ml-engine local - - $ gcloud beta ml-engine local - diff --git a/gcloud/alpha/ml-engine/local/predict b/gcloud/alpha/ml-engine/local/predict deleted file mode 100644 index d197e68f2..000000000 --- a/gcloud/alpha/ml-engine/local/predict +++ /dev/null @@ -1,91 +0,0 @@ -NAME - gcloud alpha ml-engine local predict - run prediction locally - -SYNOPSIS - gcloud alpha ml-engine local predict --model-dir=MODEL_DIR - (--json-instances=JSON_INSTANCES | --json-request=JSON_REQUEST - | --text-instances=TEXT_INSTANCES) [--framework=FRAMEWORK] - [--signature-name=SIGNATURE_NAME] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) gcloud alpha ml-engine local predict performs prediction locally - with the given instances. It requires the TensorFlow SDK - (https://www.tensorflow.org/install) be installed locally. The output - format mirrors gcloud ai-platform predict (online prediction). - - You cannot use this command with custom prediction routines. - -REQUIRED FLAGS - --model-dir=MODEL_DIR - Path to the model. - - Exactly one of these must be specified: - - --json-instances=JSON_INSTANCES - Path to a local file from which instances are read. Instances are in - JSON format; newline delimited. - - An example of the JSON instances file: - - {"images": [0.0, ..., 0.1], "key": 3} - {"images": [0.0, ..., 0.1], "key": 2} - ... - - This flag accepts "-" for stdin. - - --json-request=JSON_REQUEST - Path to a local file containing the body of JSON request. - - An example of a JSON request: - - { - "instances": [ - {"x": [1, 2], "y": [3, 4]}, - {"x": [-1, -2], "y": [-3, -4]} - ] - } - - This flag accepts "-" for stdin. - - --text-instances=TEXT_INSTANCES - Path to a local file from which instances are read. Instances are in - UTF-8 encoded text format; newline delimited. - - An example of the text instances file: - - 107,4.9,2.5,4.5,1.7 - 100,5.7,2.8,4.1,1.3 - ... - - This flag accepts "-" for stdin. - -OPTIONAL FLAGS - --framework=FRAMEWORK - ML framework used to train this version of the model. If not specified, - defaults to 'tensorflow'. FRAMEWORK must be one of: scikit-learn, - tensorflow, xgboost. - - --signature-name=SIGNATURE_NAME - Name of the signature defined in the SavedModel to use for this job. - Defaults to DEFAULT_SERVING_SIGNATURE_DEF_KEY in - https://www.tensorflow.org/api_docs/python/tf/compat/v1/saved_model/signature_constants, - which is "serving_default". Only applies to TensorFlow models. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine local predict - - $ gcloud beta ml-engine local predict - diff --git a/gcloud/alpha/ml-engine/local/train b/gcloud/alpha/ml-engine/local/train deleted file mode 100644 index 1d56acdac..000000000 --- a/gcloud/alpha/ml-engine/local/train +++ /dev/null @@ -1,111 +0,0 @@ -NAME - gcloud alpha ml-engine local train - run an AI Platform training job - locally - -SYNOPSIS - gcloud alpha ml-engine local train --module-name=MODULE_NAME - [--distributed] [--evaluator-count=EVALUATOR_COUNT] [--job-dir=JOB_DIR] - [--package-path=PACKAGE_PATH] - [--parameter-server-count=PARAMETER_SERVER_COUNT] - [--start-port=START_PORT; default=27182] [--worker-count=WORKER_COUNT] - [GCLOUD_WIDE_FLAG ...] [-- USER_ARGS ...] - -DESCRIPTION - (ALPHA) This command runs the specified module in an environment similar to - that of a live AI Platform Training Job. - - This is especially useful in the case of testing distributed models, as it - allows you to validate that you are properly interacting with the AI - Platform cluster configuration. If your model expects a specific number of - parameter servers or workers (i.e. you expect to use the CUSTOM machine - type), use the --parameter-server-count and --worker-count flags to further - specify the desired cluster configuration, just as you would in your cloud - training job configuration: - - $ gcloud alpha ml-engine local train --module-name trainer.task \ - --package-path /path/to/my/code/trainer \ - --distributed \ - --parameter-server-count 4 \ - --worker-count 8 - - Unlike submitting a training job, the --package-path parameter can be - omitted, and will use your current working directory. - - AI Platform Training sets a TF_CONFIG environment variable on each VM in - your training job. You can use TF_CONFIG to access the cluster description - and the task description for each VM. - - Learn more about TF_CONFIG: - https://cloud.google.com/ai-platform/training/docs/distributed-training-details. - -POSITIONAL ARGUMENTS - [-- USER_ARGS ...] - Additional user arguments to be forwarded to user code. Any relative - paths will be relative to the parent directory of --package-path. - - The '--' argument must be specified between gcloud specific args on the - left and USER_ARGS on the right. - -REQUIRED FLAGS - --module-name=MODULE_NAME - Name of the module to run. - -OPTIONAL FLAGS - --distributed - Runs the provided code in distributed mode by providing cluster - configurations as environment variables to subprocesses - - --evaluator-count=EVALUATOR_COUNT - Number of evaluators with which to run. Ignored if --distributed is not - specified. Default: 0 - - --job-dir=JOB_DIR - Cloud Storage path or local_directory in which to store training - outputs and other data needed for training. - - This path will be passed to your TensorFlow program as the --job-dir - command-line arg. The benefit of specifying this field is that AI - Platform will validate the path for use in training. However, note that - your training program will need to parse the provided --job-dir - argument. - - --package-path=PACKAGE_PATH - Path to a Python package to build. This should point to a local - directory containing the Python source for the job. It will be built - using setuptools (which must be installed) using its parent directory - as context. If the parent directory contains a setup.py file, the build - will use that; otherwise, it will use a simple built-in one. - - --parameter-server-count=PARAMETER_SERVER_COUNT - Number of parameter servers with which to run. Ignored if --distributed - is not specified. Default: 2 - - --start-port=START_PORT; default=27182 - Start of the range of ports reserved by the local cluster. This command - will use a contiguous block of ports equal to parameter-server-count + - worker-count + 1. - - If --distributed is not specified, this flag is ignored. - - --worker-count=WORKER_COUNT - Number of workers with which to run. Ignored if --distributed is not - specified. Default: 2 - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine local train - - $ gcloud beta ml-engine local train - diff --git a/gcloud/alpha/ml-engine/locations/describe b/gcloud/alpha/ml-engine/locations/describe deleted file mode 100644 index f40e282b2..000000000 --- a/gcloud/alpha/ml-engine/locations/describe +++ /dev/null @@ -1,59 +0,0 @@ -NAME - gcloud alpha ml-engine locations describe - display AI Platform - capabilities in a location - -SYNOPSIS - gcloud alpha ml-engine locations describe LOCATION [--region=REGION] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Display AI Platform capabilities in a location. - -POSITIONAL ARGUMENTS - Location resource - The location you want to show details for. This - represents a Cloud resource. (NOTE) Some attributes are not given - arguments in this group but can be set in other ways. - - To set the project attribute: - ◆ provide the argument location on the command line with a fully - specified name; - ◆ provide the argument --project on the command line; - ◆ set the property core/project. - - This must be specified. - - LOCATION - ID of the location or fully qualified identifier for the location. - - To set the name attribute: - ▸ provide the argument location on the command line. - -FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - If unspecified, the command uses the global endpoint of the AI Platform - Training and Prediction API. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: asia-east1, asia-northeast1, asia-southeast1, - australia-southeast1, europe-west1, europe-west2, europe-west3, - europe-west4, northamerica-northeast1, us-central1, us-east1, us-east4, - us-west1. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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/ml-engine/locations/help b/gcloud/alpha/ml-engine/locations/help deleted file mode 100644 index 719dac7d3..000000000 --- a/gcloud/alpha/ml-engine/locations/help +++ /dev/null @@ -1,30 +0,0 @@ -NAME - gcloud alpha ml-engine locations - query AI Platform location capabilities - -SYNOPSIS - gcloud alpha ml-engine locations COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) The gcloud alpha ml-engine locations command group lets you query - AI Platform 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) Display AI Platform capabilities in a location. - - list - (ALPHA) List AI Platform 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. - diff --git a/gcloud/alpha/ml-engine/models/add-iam-policy-binding b/gcloud/alpha/ml-engine/models/add-iam-policy-binding deleted file mode 100644 index a5e72a55f..000000000 --- a/gcloud/alpha/ml-engine/models/add-iam-policy-binding +++ /dev/null @@ -1,143 +0,0 @@ -NAME - gcloud alpha ml-engine models add-iam-policy-binding - add IAM policy - binding for a model - -SYNOPSIS - gcloud alpha ml-engine models add-iam-policy-binding MODEL - --member=PRINCIPAL --role=ROLE [--region=REGION] - [--condition=[KEY=VALUE,...] | --condition-from-file=PATH_TO_FILE] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Adds a policy binding to the IAM policy of a ML engine model, given - a model ID and the binding. One binding consists of a member, a role, and - an optional condition. - -EXAMPLES - To add an IAM policy binding for the role of roles/ml.admin for the user - test-user@gmail.com on a model with identifier my_model, run: - - $ gcloud alpha ml-engine models add-iam-policy-binding my_model \ - --member='user:test-user@gmail.com' --role='roles/ml.admin' - - To add an IAM policy binding for the role of roles/ml.admin to the service - account test-proj1@example.domain.com, run: - - $ gcloud alpha ml-engine models add-iam-policy-binding my_model \ - --member='serviceAccount:test-proj1@example.domain.com' \ - --role='roles/ml.admin' - - To add an IAM policy binding for the role of roles/ml.admin for all - authenticated users on a model with identifier my_model, run: - - $ gcloud alpha ml-engine models add-iam-policy-binding my_model \ - --member='allAuthenticatedUsers' --role='roles/ml.admin' - - To add an IAM policy binding that expires at the end of the year 2018 for - the role of roles/ml.admin and the user test-user@gmail.com on a model with - identifier my_model, run: - - $ gcloud alpha ml-engine models add-iam-policy-binding my_model \ - --member='user:test-user@gmail.com' --role='roles/ml.admin' \ - --condition='expression=request.time < - timestamp("2019-01-01T00:00:00Z"),title=expires_end_of_2018,descrip\ - tion=Expires at midnight on 2018-12-31' - - See https://cloud.google.com/iam/docs/managing-policies for details of - policy role and principal types. - -POSITIONAL ARGUMENTS - MODEL - Name of the model. - -REQUIRED FLAGS - --member=PRINCIPAL - The principal to add the binding for. Should be of the form - user|group|serviceAccount:email or domain:domain. - - Examples: user:test-user@gmail.com, group:admins@example.com, - serviceAccount:test123@example.domain.com, or - domain:example.domain.com. - - Some resources also accept the following special values: - ◆ allUsers - Special identifier that represents anyone who is on the - internet, with or without a Google account. - ◆ allAuthenticatedUsers - Special identifier that represents anyone - who is authenticated with a Google account or a service account. - - --role=ROLE - Role name to assign to the principal. The role name is the complete - path of a predefined role, such as roles/logging.viewer, or the role ID - for a custom role, such as - organizations/{ORGANIZATION_ID}/roles/logging.viewer. - -OPTIONAL FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - - At most one of these can be specified: - - --condition=[KEY=VALUE,...] - A condition to include in the binding. When the condition is - explicitly specified as None (--condition=None), a binding without a - condition is added. When the condition is specified and is not None, - --role cannot be a basic role. Basic roles are roles/editor, - roles/owner, and roles/viewer. For more on conditions, refer to the - conditions overview guide: - https://cloud.google.com/iam/docs/conditions-overview - - When using the --condition flag, include the following key-value - pairs: - - expression - (Required) Condition expression that evaluates to True or False. - This uses a subset of Common Expression Language syntax. - - If the condition expression includes a comma, use a different - delimiter to separate the key-value pairs. Specify the delimiter - before listing the key-value pairs. For example, to specify a - colon (:) as the delimiter, do the following: - --condition=^:^title=TITLE:expression=EXPRESSION. For more - information, see - https://cloud.google.com/sdk/gcloud/reference/topic/escaping. - - title - (Required) A short string describing the purpose of the - expression. - - description - (Optional) Additional description for the expression. - - --condition-from-file=PATH_TO_FILE - Path to a local JSON or YAML file that defines the condition. To see - available fields, see the help for --condition. Use a full or - relative path to a local file containing the value of condition. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine models add-iam-policy-binding - - $ gcloud beta ml-engine models add-iam-policy-binding - diff --git a/gcloud/alpha/ml-engine/models/create b/gcloud/alpha/ml-engine/models/create deleted file mode 100644 index 90077f08b..000000000 --- a/gcloud/alpha/ml-engine/models/create +++ /dev/null @@ -1,89 +0,0 @@ -NAME - gcloud alpha ml-engine models create - create a new AI Platform model - -SYNOPSIS - gcloud alpha ml-engine models create MODEL [--description=DESCRIPTION] - [--enable-console-logging] [--enable-logging] - [--labels=[KEY=VALUE,...]] - [--region=REGION | --regions=REGION,[REGION,...]] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Create a new AI Platform model. - -POSITIONAL ARGUMENTS - MODEL - Name of the model. - -FLAGS - --description=DESCRIPTION - Description of the model. - - --enable-console-logging - If set, enables StackDriver Logging of stderr and stdout streams for - online prediction. These logs are more verbose than the standard access - logs and can be helpful for debugging. - - --enable-logging - If set, enables StackDriver Logging for online prediction. These logs - are like standard server access logs, containing information such as - timestamps and latency for each request. - - --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 these can be specified: - - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - - If you specify this flag, do not specify --regions. - - If you specify --region=global, the model will be deployed to - 'us-central1' by default using the global endpoint. Please use - --regions only if you want to change the region where the model will - be deployed against the global endpoint. - - If both flags are unspecified and you don't set ai_platform/region, - you will be prompted for region of the regional endpoint. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - - --regions=REGION,[REGION,...] - The Google Cloud region where the model will be deployed (currently - only a single region is supported) against the global endpoint. - - If you specify this flag, do not specify --region. - - Defaults to 'us-central1' while using the global endpoint. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine models create - - $ gcloud beta ml-engine models create - diff --git a/gcloud/alpha/ml-engine/models/delete b/gcloud/alpha/ml-engine/models/delete deleted file mode 100644 index 623373951..000000000 --- a/gcloud/alpha/ml-engine/models/delete +++ /dev/null @@ -1,50 +0,0 @@ -NAME - gcloud alpha ml-engine models delete - delete an existing AI Platform model - -SYNOPSIS - gcloud alpha ml-engine models delete MODEL [--region=REGION] - [GCLOUD_WIDE_FLAG ...] - -EXAMPLES - To delete all models matching the regular expression vision[0-9]+, run: - - $ gcloud alpha ml-engine models list --uri \ - --filter 'name ~ vision[0-9]+' | xargs -n 1 gcloud alpha \ - ml-engine models delete - -POSITIONAL ARGUMENTS - MODEL - Name of the model. - -FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine models delete - - $ gcloud beta ml-engine models delete - diff --git a/gcloud/alpha/ml-engine/models/describe b/gcloud/alpha/ml-engine/models/describe deleted file mode 100644 index 450e6876a..000000000 --- a/gcloud/alpha/ml-engine/models/describe +++ /dev/null @@ -1,50 +0,0 @@ -NAME - gcloud alpha ml-engine models describe - describe an existing AI Platform - model - -SYNOPSIS - gcloud alpha ml-engine models describe MODEL [--region=REGION] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Describe an existing AI Platform model. - - If you would like to see all versions of a model, use gcloud ai-platform - versions list. - -POSITIONAL ARGUMENTS - MODEL - Name of the model. - -FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine models describe - - $ gcloud beta ml-engine models describe - diff --git a/gcloud/alpha/ml-engine/models/get-iam-policy b/gcloud/alpha/ml-engine/models/get-iam-policy deleted file mode 100644 index 57587c946..000000000 --- a/gcloud/alpha/ml-engine/models/get-iam-policy +++ /dev/null @@ -1,96 +0,0 @@ -NAME - gcloud alpha ml-engine models get-iam-policy - get the IAM policy for a - model - -SYNOPSIS - gcloud alpha ml-engine models get-iam-policy MODEL [--region=REGION] - [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] - [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Gets the IAM policy for the given model. - - Returns an empty policy if the resource does not have a policy set. - -EXAMPLES - The following command gets the IAM policy for the model my_model: - - $ gcloud alpha ml-engine models get-iam-policy my_model - -POSITIONAL ARGUMENTS - Model resource - The AI Platform model to set IAM policy for. 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 model 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. - - MODEL - ID of the model or fully qualified identifier for the model. - - To set the name attribute: - ▸ provide the argument model on the command line. - -FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - -LIST COMMAND FLAGS - --filter=EXPRESSION - Apply a Boolean filter EXPRESSION to each resource item to be listed. - If the expression evaluates True, then that item is listed. For more - details and examples of filter expressions, run $ gcloud topic filters. - This flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --limit=LIMIT - Maximum number of resources to list. The default is unlimited. This - flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --page-size=PAGE_SIZE - Some services group resource list output into pages. This flag - specifies the maximum number of resources per page. The default is - determined by the service if it supports paging, otherwise it is - unlimited (no paging). Paging may be applied before or after --filter - and --limit depending on the service. - - --sort-by=[FIELD,...] - Comma-separated list of resource field key names to sort by. The - default order is ascending. Prefix a field with ``~'' for descending - order on that field. This flag interacts with other flags that are - applied in this order: --flatten, --sort-by, --filter, --limit. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -NOTES - This command is currently in alpha and might change without notice. If this - command fails 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 ml-engine models get-iam-policy - - $ gcloud beta ml-engine models get-iam-policy - diff --git a/gcloud/alpha/ml-engine/models/help b/gcloud/alpha/ml-engine/models/help deleted file mode 100644 index dc2f9db5c..000000000 --- a/gcloud/alpha/ml-engine/models/help +++ /dev/null @@ -1,61 +0,0 @@ -NAME - gcloud alpha ml-engine models - AI Platform Models commands - -SYNOPSIS - gcloud alpha ml-engine models COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) An AI Platform model is a container representing an ML application - or service. A model may contain multiple versions which act as the - implementation of the service. See also: - - $ gcloud alpha ml-engine versions --help. - - For more information, please see - https://cloud.google.com/ml/docs/concepts/technical-overview#model - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -COMMANDS - COMMAND is one of the following: - - add-iam-policy-binding - (ALPHA) Add IAM policy binding for a model. - - create - (ALPHA) Create a new AI Platform model. - - delete - (ALPHA) Delete an existing AI Platform model. - - describe - (ALPHA) Describe an existing AI Platform model. - - get-iam-policy - (ALPHA) Get the IAM policy for a model. - - list - (ALPHA) List existing AI Platform models. - - remove-iam-policy-binding - (ALPHA) Remove IAM policy binding for a model. - - set-iam-policy - (ALPHA) Set the IAM policy for a model. - - update - (ALPHA) Update an existing AI Platform model. - -NOTES - This command is currently in alpha and might change without notice. If this - command fails 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 ml-engine models - - $ gcloud beta ml-engine models - diff --git a/gcloud/alpha/ml-engine/models/list b/gcloud/alpha/ml-engine/models/list deleted file mode 100644 index ae3598ee4..000000000 --- a/gcloud/alpha/ml-engine/models/list +++ /dev/null @@ -1,75 +0,0 @@ -NAME - gcloud alpha ml-engine models list - list existing AI Platform models - -SYNOPSIS - gcloud alpha ml-engine models list [--region=REGION] [--filter=EXPRESSION] - [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) List existing AI Platform models. - -FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - -LIST COMMAND FLAGS - --filter=EXPRESSION - Apply a Boolean filter EXPRESSION to each resource item to be listed. - If the expression evaluates True, then that item is listed. For more - details and examples of filter expressions, run $ gcloud topic filters. - This flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --limit=LIMIT - Maximum number of resources to list. The default is unlimited. This - flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --page-size=PAGE_SIZE - Some services group resource list output into pages. This flag - specifies the maximum number of resources per page. The default is - determined by the service if it supports paging, otherwise it is - unlimited (no paging). Paging may be applied before or after --filter - and --limit depending on the service. - - --sort-by=[FIELD,...] - Comma-separated list of resource field key names to sort by. The - default order is ascending. Prefix a field with ``~'' for descending - order on that field. This flag interacts with other flags that are - applied in this order: --flatten, --sort-by, --filter, --limit. - - --uri - Print a list of resource URIs instead of the default output, and change - the command output to a list of URIs. If this flag is used with - --format, the formatting is applied on this URI list. To display URIs - alongside other keys instead, use the uri() transform. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -NOTES - This command is currently in alpha and might change without notice. If this - command fails with API permission errors despite specifying the correct - project, you might be trying to access an API with an invitation-only early - access allowlist. These variants are also available: - - $ gcloud ml-engine models list - - $ gcloud beta ml-engine models list - diff --git a/gcloud/alpha/ml-engine/models/remove-iam-policy-binding b/gcloud/alpha/ml-engine/models/remove-iam-policy-binding deleted file mode 100644 index 85a990950..000000000 --- a/gcloud/alpha/ml-engine/models/remove-iam-policy-binding +++ /dev/null @@ -1,147 +0,0 @@ -NAME - gcloud alpha ml-engine models remove-iam-policy-binding - remove IAM policy - binding for a model - -SYNOPSIS - gcloud alpha ml-engine models remove-iam-policy-binding MODEL - --member=PRINCIPAL --role=ROLE [--region=REGION] - [--all | --condition=[KEY=VALUE,...] - | --condition-from-file=PATH_TO_FILE] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Remove an IAM policy binding from the IAM policy of a ML model. One - binding consists of a member, a role, and an optional condition. See $ - gcloud alpha ml-engine models get-iam-policy for examples of how to specify - a model resource. - -EXAMPLES - To remove an IAM policy binding for the role of roles/ml.admin for the user - test-user@gmail.com on model with identifier my_model, run: - - $ gcloud alpha ml-engine models remove-iam-policy-binding my_model \ - --member='user:test-user@gmail.com' --role='roles/ml.admin' - - To remove an IAM policy binding for the role of roles/ml.admin from all - authenticated users on model my_model, run: - - $ gcloud alpha ml-engine models remove-iam-policy-binding my_model \ - --member='allAuthenticatedUsers' --role='roles/ml.admin' - - See https://cloud.google.com/iam/docs/managing-policies for details of - policy role and member types. - -POSITIONAL ARGUMENTS - Model resource - The AI Platform model for which to remove IAM policy - binding from. 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 model 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. - - MODEL - ID of the model or fully qualified identifier for the model. - - To set the name attribute: - ▸ provide the argument model on the command line. - -REQUIRED FLAGS - --member=PRINCIPAL - The principal to remove the binding for. Should be of the form - user|group|serviceAccount:email or domain:domain. - - Examples: user:test-user@gmail.com, group:admins@example.com, - serviceAccount:test123@example.domain.com, or - domain:example.domain.com. - - Deleted principals have an additional deleted: prefix and a ?uid=UID - suffix, where UID is a unique identifier for the principal. Example: - deleted:user:test-user@gmail.com?uid=123456789012345678901. - - Some resources also accept the following special values: - ◆ allUsers - Special identifier that represents anyone who is on the - internet, with or without a Google account. - ◆ allAuthenticatedUsers - Special identifier that represents anyone - who is authenticated with a Google account or a service account. - - --role=ROLE - The role to remove the principal from. - -OPTIONAL FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - - At most one of these can be specified: - - --all - Remove all bindings with this role and principal, irrespective of any - conditions. - - --condition=[KEY=VALUE,...] - The condition of the binding that you want to remove. When the - condition is explicitly specified as None (--condition=None), a - binding without a condition is removed. Otherwise, only a binding - with a condition that exactly matches the specified condition - (including the optional description) is removed. For more on - conditions, refer to the conditions overview guide: - https://cloud.google.com/iam/docs/conditions-overview - - When using the --condition flag, include the following key-value - pairs: - - expression - (Required) Condition expression that evaluates to True or False. - This uses a subset of Common Expression Language syntax. - - If the condition expression includes a comma, use a different - delimiter to separate the key-value pairs. Specify the delimiter - before listing the key-value pairs. For example, to specify a - colon (:) as the delimiter, do the following: - --condition=^:^title=TITLE:expression=EXPRESSION. For more - information, see - https://cloud.google.com/sdk/gcloud/reference/topic/escaping. - - title - (Required) A short string describing the purpose of the - expression. - - description - (Optional) Additional description for the expression. - - --condition-from-file=PATH_TO_FILE - Path to a local JSON or YAML file that defines the condition. To see - available fields, see the help for --condition. Use a full or - relative path to a local file containing the value of condition. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine models remove-iam-policy-binding - - $ gcloud beta ml-engine models remove-iam-policy-binding - diff --git a/gcloud/alpha/ml-engine/models/set-iam-policy b/gcloud/alpha/ml-engine/models/set-iam-policy deleted file mode 100644 index 989039bab..000000000 --- a/gcloud/alpha/ml-engine/models/set-iam-policy +++ /dev/null @@ -1,79 +0,0 @@ -NAME - gcloud alpha ml-engine models set-iam-policy - set the IAM policy for a - model - -SYNOPSIS - gcloud alpha ml-engine models set-iam-policy MODEL POLICY_FILE - [--region=REGION] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Sets the IAM policy for the given model as defined in a JSON or - YAML file. - - See https://cloud.google.com/iam/docs/managing-policies for details of the - policy file format and contents. - -EXAMPLES - The following command will read am IAM policy defined in a JSON file - 'policy.json' and set it for the model my_model: - - $ gcloud alpha ml-engine models set-iam-policy my_model policy.json - -POSITIONAL ARGUMENTS - Model resource - The AI Platform model to set IAM policy for. 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 model 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. - - MODEL - ID of the model or fully qualified identifier for the model. - - To set the name attribute: - ▸ provide the argument model on the command line. - - POLICY_FILE - Path to a local JSON or YAML formatted file containing a valid policy. - - The output of the get-iam-policy command is a valid file, as is any - JSON or YAML file conforming to the structure of a Policy - (https://cloud.google.com/iam/reference/rest/v1/Policy). - -FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine models set-iam-policy - - $ gcloud beta ml-engine models set-iam-policy - diff --git a/gcloud/alpha/ml-engine/models/update b/gcloud/alpha/ml-engine/models/update deleted file mode 100644 index c04ad69ad..000000000 --- a/gcloud/alpha/ml-engine/models/update +++ /dev/null @@ -1,79 +0,0 @@ -NAME - gcloud alpha ml-engine models update - update an existing AI Platform model - -SYNOPSIS - gcloud alpha ml-engine models update MODEL [--description=DESCRIPTION] - [--region=REGION] [--update-labels=[KEY=VALUE,...]] - [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Update an existing AI Platform model. - -POSITIONAL ARGUMENTS - MODEL - Name of the model. - -FLAGS - --description=DESCRIPTION - Description of the model. - - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - - --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 ml-engine models update --clear-labels - - To remove all existing labels and create two new labels, foo and baz: - - $ gcloud alpha ml-engine models update --clear-labels \ - --update-labels foo=bar,baz=qux - - --remove-labels=[KEY,...] - List of label keys to remove. If a label does not exist it is - silently ignored. If --update-labels is also specified then - --update-labels is applied first. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -NOTES - This command is currently in alpha and might change without notice. If this - command fails with API permission errors despite specifying the correct - project, you might be trying to access an API with an invitation-only early - access allowlist. These variants are also available: - - $ gcloud ml-engine models update - - $ gcloud beta ml-engine models update - diff --git a/gcloud/alpha/ml-engine/operations/cancel b/gcloud/alpha/ml-engine/operations/cancel deleted file mode 100644 index 18bda85d6..000000000 --- a/gcloud/alpha/ml-engine/operations/cancel +++ /dev/null @@ -1,47 +0,0 @@ -NAME - gcloud alpha ml-engine operations cancel - cancel an AI Platform operation - -SYNOPSIS - gcloud alpha ml-engine operations cancel OPERATION [--region=REGION] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Cancel an AI Platform operation. - -POSITIONAL ARGUMENTS - OPERATION - Name of the operation. - -FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - If unspecified, the command uses the global endpoint of the AI Platform - Training and Prediction API. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: asia-east1, asia-northeast1, asia-southeast1, - australia-southeast1, europe-west1, europe-west2, europe-west3, - europe-west4, northamerica-northeast1, us-central1, us-east1, us-east4, - us-west1. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine operations cancel - - $ gcloud beta ml-engine operations cancel - diff --git a/gcloud/alpha/ml-engine/operations/describe b/gcloud/alpha/ml-engine/operations/describe deleted file mode 100644 index a769fdb21..000000000 --- a/gcloud/alpha/ml-engine/operations/describe +++ /dev/null @@ -1,48 +0,0 @@ -NAME - gcloud alpha ml-engine operations describe - describe an AI Platform - operation - -SYNOPSIS - gcloud alpha ml-engine operations describe OPERATION [--region=REGION] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Describe an AI Platform operation. - -POSITIONAL ARGUMENTS - OPERATION - Name of the operation. - -FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - If unspecified, the command uses the global endpoint of the AI Platform - Training and Prediction API. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: asia-east1, asia-northeast1, asia-southeast1, - australia-southeast1, europe-west1, europe-west2, europe-west3, - europe-west4, northamerica-northeast1, us-central1, us-east1, us-east4, - us-west1. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine operations describe - - $ gcloud beta ml-engine operations describe - diff --git a/gcloud/alpha/ml-engine/operations/help b/gcloud/alpha/ml-engine/operations/help deleted file mode 100644 index 85d5f1cda..000000000 --- a/gcloud/alpha/ml-engine/operations/help +++ /dev/null @@ -1,39 +0,0 @@ -NAME - gcloud alpha ml-engine operations - manage AI Platform operations - -SYNOPSIS - gcloud alpha ml-engine operations COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Manage AI Platform operations. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -COMMANDS - COMMAND is one of the following: - - cancel - (ALPHA) Cancel an AI Platform operation. - - describe - (ALPHA) Describe an AI Platform operation. - - list - (ALPHA) List existing AI Platform jobs. - - wait - (ALPHA) Wait for an AI Platform operation to complete. - -NOTES - This command is currently in alpha and might change without notice. If this - command fails 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 ml-engine operations - - $ gcloud beta ml-engine operations - diff --git a/gcloud/alpha/ml-engine/operations/list b/gcloud/alpha/ml-engine/operations/list deleted file mode 100644 index af36fc21a..000000000 --- a/gcloud/alpha/ml-engine/operations/list +++ /dev/null @@ -1,76 +0,0 @@ -NAME - gcloud alpha ml-engine operations list - list existing AI Platform jobs - -SYNOPSIS - gcloud alpha ml-engine operations list [--region=REGION] - [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] - [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) List existing AI Platform jobs. - -FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - If unspecified, the command uses the global endpoint of the AI Platform - Training and Prediction API. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: asia-east1, asia-northeast1, asia-southeast1, - australia-southeast1, europe-west1, europe-west2, europe-west3, - europe-west4, northamerica-northeast1, us-central1, us-east1, us-east4, - us-west1. - -LIST COMMAND FLAGS - --filter=EXPRESSION - Apply a Boolean filter EXPRESSION to each resource item to be listed. - If the expression evaluates True, then that item is listed. For more - details and examples of filter expressions, run $ gcloud topic filters. - This flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --limit=LIMIT - Maximum number of resources to list. The default is unlimited. This - flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --page-size=PAGE_SIZE - Some services group resource list output into pages. This flag - specifies the maximum number of resources per page. The default is - determined by the service if it supports paging, otherwise it is - unlimited (no paging). Paging may be applied before or after --filter - and --limit depending on the service. - - --sort-by=[FIELD,...] - Comma-separated list of resource field key names to sort by. The - default order is ascending. Prefix a field with ``~'' for descending - order on that field. This flag interacts with other flags that are - applied in this order: --flatten, --sort-by, --filter, --limit. - - --uri - Print a list of resource URIs instead of the default output, and change - the command output to a list of URIs. If this flag is used with - --format, the formatting is applied on this URI list. To display URIs - alongside other keys instead, use the uri() transform. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -NOTES - This command is currently in alpha and might change without notice. If this - command fails with API permission errors despite specifying the correct - project, you might be trying to access an API with an invitation-only early - access allowlist. These variants are also available: - - $ gcloud ml-engine operations list - - $ gcloud beta ml-engine operations list - diff --git a/gcloud/alpha/ml-engine/operations/wait b/gcloud/alpha/ml-engine/operations/wait deleted file mode 100644 index 9d40e576c..000000000 --- a/gcloud/alpha/ml-engine/operations/wait +++ /dev/null @@ -1,52 +0,0 @@ -NAME - gcloud alpha ml-engine operations wait - wait for an AI Platform operation - to complete - -SYNOPSIS - gcloud alpha ml-engine operations wait OPERATION [--region=REGION] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Wait for an AI Platform operation to complete. - - Given an operation ID, this command polls the operation and blocks until it - completes. At completion, the operation message is printed (which includes - the operation response). - -POSITIONAL ARGUMENTS - OPERATION - Name of the operation. - -FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - If unspecified, the command uses the global endpoint of the AI Platform - Training and Prediction API. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: asia-east1, asia-northeast1, asia-southeast1, - australia-southeast1, europe-west1, europe-west2, europe-west3, - europe-west4, northamerica-northeast1, us-central1, us-east1, us-east4, - us-west1. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine operations wait - - $ gcloud beta ml-engine operations wait - diff --git a/gcloud/alpha/ml-engine/predict b/gcloud/alpha/ml-engine/predict deleted file mode 100644 index a1ea1e059..000000000 --- a/gcloud/alpha/ml-engine/predict +++ /dev/null @@ -1,109 +0,0 @@ -NAME - gcloud alpha ml-engine predict - run AI Platform online prediction - -SYNOPSIS - gcloud alpha ml-engine predict --model=MODEL - (--json-instances=JSON_INSTANCES | --json-request=JSON_REQUEST - | --text-instances=TEXT_INSTANCES) [--region=REGION] - [--signature-name=SIGNATURE_NAME] [--version=VERSION] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) gcloud alpha ml-engine predict sends a prediction request to AI - Platform for the given instances. This command will read up to 100 - instances, though the service itself will accept instances up to the - payload limit size (currently, 1.5MB). If you are predicting on more - instances, you should use batch prediction via - - $ gcloud alpha ml-engine jobs submit prediction. - -REQUIRED FLAGS - --model=MODEL - Name of the model. - - Exactly one of these must be specified: - - --json-instances=JSON_INSTANCES - Path to a local file from which instances are read. Instances are in - JSON format; newline delimited. - - An example of the JSON instances file: - - {"images": [0.0, ..., 0.1], "key": 3} - {"images": [0.0, ..., 0.1], "key": 2} - ... - - This flag accepts "-" for stdin. - - --json-request=JSON_REQUEST - Path to a local file containing the body of JSON request. - - An example of a JSON request: - - { - "instances": [ - {"x": [1, 2], "y": [3, 4]}, - {"x": [-1, -2], "y": [-3, -4]} - ] - } - - This flag accepts "-" for stdin. - - --text-instances=TEXT_INSTANCES - Path to a local file from which instances are read. Instances are in - UTF-8 encoded text format; newline delimited. - - An example of the text instances file: - - 107,4.9,2.5,4.5,1.7 - 100,5.7,2.8,4.1,1.3 - ... - - This flag accepts "-" for stdin. - -OPTIONAL FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - - --signature-name=SIGNATURE_NAME - Name of the signature defined in the SavedModel to use for this job. - Defaults to DEFAULT_SERVING_SIGNATURE_DEF_KEY in - https://www.tensorflow.org/api_docs/python/tf/compat/v1/saved_model/signature_constants, - which is "serving_default". Only applies to TensorFlow models. - - --version=VERSION - Model version to be used. - - If unspecified, the default version of the model will be used. To list - model versions run - - $ gcloud alpha ml-engine versions list - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -NOTES - This command is currently in alpha and might change without notice. If this - command fails with API permission errors despite specifying the correct - project, you might be trying to access an API with an invitation-only early - access allowlist. These variants are also available: - - $ gcloud ml-engine predict - - $ gcloud beta ml-engine predict - diff --git a/gcloud/alpha/ml-engine/versions/create b/gcloud/alpha/ml-engine/versions/create deleted file mode 100644 index fb8a20b43..000000000 --- a/gcloud/alpha/ml-engine/versions/create +++ /dev/null @@ -1,260 +0,0 @@ -NAME - gcloud alpha ml-engine versions create - create a new AI Platform version - -SYNOPSIS - gcloud alpha ml-engine versions create VERSION --model=MODEL - [--accelerator=[count=COUNT],[type=TYPE]] [--async] [--config=CONFIG] - [--description=DESCRIPTION] [--explanation-method=EXPLANATION_METHOD] - [--framework=FRAMEWORK] [--labels=[KEY=VALUE,...]] - [--machine-type=MACHINE_TYPE] - [--num-integral-steps=NUM_INTEGRAL_STEPS; default=50] - [--num-paths=NUM_PATHS; default=50] [--origin=ORIGIN] - [--python-version=PYTHON_VERSION] [--region=REGION] - [--runtime-version=RUNTIME_VERSION] [--service-account=SERVICE_ACCOUNT] - [--staging-bucket=STAGING_BUCKET] - [--args=[ARG,...] --command=[COMMAND,...] - --env-vars=[KEY=VALUE,...] --image=IMAGE --ports=[ARG,...]] - [--health-route=HEALTH_ROUTE --predict-route=PREDICT_ROUTE] - [--max-nodes=MAX_NODES - --metric-targets=[METRIC-NAME=TARGET,...] --min-nodes=MIN_NODES] - [--package-uris=[PACKAGE_URI,...] --prediction-class=PREDICTION_CLASS] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Creates a new version of an AI Platform model. - - For more details on managing AI Platform models and versions see - https://cloud.google.com/ai-platform/prediction/docs/managing-models-jobs - -EXAMPLES - To create an AI Platform version model with the version ID 'versionId' and - with the name 'model-name', run: - - $ gcloud alpha ml-engine versions create versionId --model=model-name - -POSITIONAL ARGUMENTS - VERSION - Name of the model version. - -REQUIRED FLAGS - --model=MODEL - Name of the model. - -OPTIONAL FLAGS - --accelerator=[count=COUNT],[type=TYPE] - Manage the accelerator config for GPU serving. When deploying a model - with Compute Engine Machine Types, a GPU accelerator may also be - selected. - - type - The type of the accelerator. Choices are 'nvidia-tesla-a100', - 'nvidia-tesla-k80', 'nvidia-tesla-p100', 'nvidia-tesla-p4', - 'nvidia-tesla-t4', 'nvidia-tesla-v100'. - - count - The number of accelerators to attach to each machine running the - job. If not specified, the default value is 1. Your model must be - specially designed to accommodate more than 1 accelerator per - machine. To configure how many replicas your model has, set the - manualScaling or autoScaling parameters. - - --async - Return immediately, without waiting for the operation in progress to - complete. - - --config=CONFIG - Path to a YAML configuration file containing configuration parameters - for the Version - (https://cloud.google.com/ai-platform/prediction/docs/reference/rest/v1/projects.models.versions) - to create. - - The file is in YAML format. Note that not all attributes of a version - are configurable; available attributes (with example values) are: - - description: A free-form description of the version. - deploymentUri: gs://path/to/source - runtimeVersion: '2.1' - # Set only one of either manualScaling or autoScaling. - manualScaling: - nodes: 10 # The number of nodes to allocate for this model. - autoScaling: - minNodes: 0 # The minimum number of nodes to allocate for this model. - labels: - user-defined-key: user-defined-value - - The name of the version must always be specified via the required - VERSION argument. - - Only one of manualScaling or autoScaling can be specified. If both are - specified in same yaml file an error will be returned. - - If an option is specified both in the configuration file and via - command-line arguments, the command-line arguments override the - configuration file. - - --description=DESCRIPTION - Description of the version. - - --explanation-method=EXPLANATION_METHOD - Enable explanations and select the explanation method to use. - - The valid options are: integrated-gradients: Use Integrated Gradients. - sampled-shapley: Use Sampled Shapley. xrai: Use XRAI. - - EXPLANATION_METHOD must be one of: integrated-gradients, - sampled-shapley, xrai. - - --framework=FRAMEWORK - ML framework used to train this version of the model. If not specified, - defaults to 'tensorflow'. FRAMEWORK must be one of: scikit-learn, - tensorflow, xgboost. - - --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. - - --machine-type=MACHINE_TYPE - Type of machine on which to serve the model. Currently only applies to - online prediction. For available machine types, see - https://cloud.google.com/ai-platform/prediction/docs/machine-types-online-prediction#available_machine_types. - - --num-integral-steps=NUM_INTEGRAL_STEPS; default=50 - Number of integral steps for Integrated Gradients. Only valid when - --explanation-method=integrated-gradients or --explanation-method=xrai - is specified. - - --num-paths=NUM_PATHS; default=50 - Number of paths for Sampled Shapley. Only valid when - --explanation-method=sampled-shapley is specified. - - --origin=ORIGIN - Location of model/ "directory" (see - https://cloud.google.com/ai-platform/prediction/docs/deploying-models#upload-model). - - This overrides deploymentUri in the --config file. If this flag is not - passed, deploymentUri must be specified in the file from --config. - - Can be a Cloud Storage (gs://) path or local file path (no prefix). In - the latter case the files will be uploaded to Cloud Storage and a - --staging-bucket argument is required. - - --python-version=PYTHON_VERSION - Version of Python used when creating the version. Choices are 3.7, 3.5, - and 2.7. However, this value must be compatible with the chosen runtime - version for the job. - - Must be used with a compatible runtime version: - - ◆ 3.7 is compatible with runtime versions 1.15 and later. - ◆ 3.5 is compatible with runtime versions 1.4 through 1.14. - ◆ 2.7 is compatible with runtime versions 1.15 and earlier. - - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - - --runtime-version=RUNTIME_VERSION - AI Platform runtime version for this job. Must be specified unless - --master-image-uri is specified instead. It is defined in documentation - along with the list of supported versions: - https://cloud.google.com/ai-platform/prediction/docs/runtime-version-list - - --service-account=SERVICE_ACCOUNT - Specifies the service account for resource access control. - - --staging-bucket=STAGING_BUCKET - Bucket in which to stage training archives. - - Required only if a file upload is necessary (that is, other flags - include local paths) and no other flags implicitly specify an upload - path. - - Configure the container to be deployed. - - --args=[ARG,...] - Comma-separated arguments passed to the command run by the container - image. If not specified and no '--command' is provided, the container - image's default Cmd is used. - - --command=[COMMAND,...] - Entrypoint for the container image. If not specified, the container - image's default Entrypoint is run. - - --env-vars=[KEY=VALUE,...] - List of key-value pairs to set as environment variables. - - --image=IMAGE - Name of the container image to deploy (e.g. - gcr.io/myproject/server:latest). - - --ports=[ARG,...] - Container ports to receive requests at. Must be a number between 1 - and 65535, inclusive. - - Flags to control the paths that requests and health checks are sent to. - - --health-route=HEALTH_ROUTE - HTTP path to send health checks to inside the container. - - --predict-route=PREDICT_ROUTE - HTTP path to send prediction requests to inside the container. - - Configure the autoscaling settings to be deployed. - - --max-nodes=MAX_NODES - The maximum number of nodes to scale this model under load. - - --metric-targets=[METRIC-NAME=TARGET,...] - List of key-value pairs to set as metrics' target for autoscaling. - Autoscaling could be based on CPU usage or GPU duty cycle, valid key - could be cpu-usage or gpu-duty-cycle. - - --min-nodes=MIN_NODES - The minimum number of nodes to scale this model under load. - - Configure user code in prediction. - - AI Platform allows a model to have user-provided prediction - code; these options configure that code. - - --package-uris=[PACKAGE_URI,...] - Comma-separated list of Cloud Storage URIs ('gs://...') for - user-supplied Python packages to use. - - --prediction-class=PREDICTION_CLASS - Fully-qualified name of the custom prediction class in the package - provided for custom prediction. - - For example, --prediction-class=my_package.SequenceModel. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine versions create - - $ gcloud beta ml-engine versions create - diff --git a/gcloud/alpha/ml-engine/versions/delete b/gcloud/alpha/ml-engine/versions/delete deleted file mode 100644 index 66fa7b55b..000000000 --- a/gcloud/alpha/ml-engine/versions/delete +++ /dev/null @@ -1,51 +0,0 @@ -NAME - gcloud alpha ml-engine versions delete - delete an existing AI Platform - version - -SYNOPSIS - gcloud alpha ml-engine versions delete VERSION --model=MODEL - [--region=REGION] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Delete an existing AI Platform version. - -POSITIONAL ARGUMENTS - VERSION - Name of the model version. - -REQUIRED FLAGS - --model=MODEL - Name of the model. - -OPTIONAL FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine versions delete - - $ gcloud beta ml-engine versions delete - diff --git a/gcloud/alpha/ml-engine/versions/describe b/gcloud/alpha/ml-engine/versions/describe deleted file mode 100644 index 795c4cb72..000000000 --- a/gcloud/alpha/ml-engine/versions/describe +++ /dev/null @@ -1,51 +0,0 @@ -NAME - gcloud alpha ml-engine versions describe - describe an existing AI Platform - version - -SYNOPSIS - gcloud alpha ml-engine versions describe VERSION --model=MODEL - [--region=REGION] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Describe an existing AI Platform version. - -POSITIONAL ARGUMENTS - VERSION - Name of the model version. - -REQUIRED FLAGS - --model=MODEL - Name of the model. - -OPTIONAL FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine versions describe - - $ gcloud beta ml-engine versions describe - diff --git a/gcloud/alpha/ml-engine/versions/help b/gcloud/alpha/ml-engine/versions/help deleted file mode 100644 index 989953f13..000000000 --- a/gcloud/alpha/ml-engine/versions/help +++ /dev/null @@ -1,51 +0,0 @@ -NAME - gcloud alpha ml-engine versions - AI Platform Versions commands - -SYNOPSIS - gcloud alpha ml-engine versions COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) A version is an implementation of a model, represented as a - serialized TensorFlow graph with trained parameters. - - When you communicate with AI Platform services, you use the combination of - the model, version, and current project to identify a specific model - implementation that is deployed in the cloud. - -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 new AI Platform version. - - delete - (ALPHA) Delete an existing AI Platform version. - - describe - (ALPHA) Describe an existing AI Platform version. - - list - (ALPHA) List existing AI Platform versions. - - set-default - (ALPHA) Sets an existing AI Platform version as the default for its - model. - - update - (ALPHA) Update an AI Platform version. - -NOTES - This command is currently in alpha and might change without notice. If this - command fails 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 ml-engine versions - - $ gcloud beta ml-engine versions - diff --git a/gcloud/alpha/ml-engine/versions/list b/gcloud/alpha/ml-engine/versions/list deleted file mode 100644 index c650d0887..000000000 --- a/gcloud/alpha/ml-engine/versions/list +++ /dev/null @@ -1,79 +0,0 @@ -NAME - gcloud alpha ml-engine versions list - list existing AI Platform versions - -SYNOPSIS - gcloud alpha ml-engine versions list --model=MODEL [--region=REGION] - [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] - [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) List existing AI Platform versions. - -REQUIRED FLAGS - --model=MODEL - Name of the model. - -FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - -LIST COMMAND FLAGS - --filter=EXPRESSION - Apply a Boolean filter EXPRESSION to each resource item to be listed. - If the expression evaluates True, then that item is listed. For more - details and examples of filter expressions, run $ gcloud topic filters. - This flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --limit=LIMIT - Maximum number of resources to list. The default is unlimited. This - flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --page-size=PAGE_SIZE - Some services group resource list output into pages. This flag - specifies the maximum number of resources per page. The default is - determined by the service if it supports paging, otherwise it is - unlimited (no paging). Paging may be applied before or after --filter - and --limit depending on the service. - - --sort-by=[FIELD,...] - Comma-separated list of resource field key names to sort by. The - default order is ascending. Prefix a field with ``~'' for descending - order on that field. This flag interacts with other flags that are - applied in this order: --flatten, --sort-by, --filter, --limit. - - --uri - Print a list of resource URIs instead of the default output, and change - the command output to a list of URIs. If this flag is used with - --format, the formatting is applied on this URI list. To display URIs - alongside other keys instead, use the uri() transform. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -NOTES - This command is currently in alpha and might change without notice. If this - command fails with API permission errors despite specifying the correct - project, you might be trying to access an API with an invitation-only early - access allowlist. These variants are also available: - - $ gcloud ml-engine versions list - - $ gcloud beta ml-engine versions list - diff --git a/gcloud/alpha/ml-engine/versions/set-default b/gcloud/alpha/ml-engine/versions/set-default deleted file mode 100644 index 8ca330fae..000000000 --- a/gcloud/alpha/ml-engine/versions/set-default +++ /dev/null @@ -1,55 +0,0 @@ -NAME - gcloud alpha ml-engine versions set-default - sets an existing AI Platform - version as the default for its model - -SYNOPSIS - gcloud alpha ml-engine versions set-default VERSION --model=MODEL - [--region=REGION] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Sets an existing AI Platform version as the default for its model. - - gcloud alpha ml-engine versions set-default sets an existing AI Platform - version as the default for its model. Only one version may be the default - for a given version. - -POSITIONAL ARGUMENTS - VERSION - Name of the model version. - -REQUIRED FLAGS - --model=MODEL - Name of the model. - -OPTIONAL FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine versions set-default - - $ gcloud beta ml-engine versions set-default - diff --git a/gcloud/alpha/ml-engine/versions/update b/gcloud/alpha/ml-engine/versions/update deleted file mode 100644 index 763f245bb..000000000 --- a/gcloud/alpha/ml-engine/versions/update +++ /dev/null @@ -1,152 +0,0 @@ -NAME - gcloud alpha ml-engine versions update - update an AI Platform version - -SYNOPSIS - gcloud alpha ml-engine versions update (VERSION : --model=MODEL) - [--config=YAML_FILE] [--description=DESCRIPTION] [--region=REGION] - [--update-labels=[KEY=VALUE,...]] - [--bigquery-table-name=BIGQUERY_TABLE_NAME - --sampling-percentage=SAMPLING_PERCENTAGE] - [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Update an AI Platform version. - -POSITIONAL ARGUMENTS - Version resource - The AI Platform model 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 version 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. - - VERSION - ID of the version or fully qualified identifier for the version. - - To set the version attribute: - ▸ provide the argument version on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --model=MODEL - Model for the version. - - To set the model attribute: - ▸ provide the argument version on the command line with a fully - specified name; - ▸ provide the argument --model on the command line. - -FLAGS - --config=YAML_FILE - Path to a YAML configuration file containing configuration parameters - for the version - (https://cloud.google.com/ml/reference/rest/v1/projects.models.versions) - to create. - - The file is in YAML format. Note that not all attributes of a version - are configurable; available attributes (with example values) are: - - description: A free-form description of the version. - manualScaling: - nodes: 10 # The number of nodes to allocate for this model. - autoScaling: - minNodes: 0 # The minimum number of nodes to allocate for this model. - maxNodes: 1 # The maxinum number of nodes to allocate for this model. - requestLoggingconfig: - bigqueryTableName: someTable # Fully qualified BigQuery table name. - samplingPercentage: 0.5 # Percentage of requests to be logged. - - The name of the version must always be specified via the required - VERSION argument. - - Only one of manualScaling or autoScaling can be specified. If both are - specified in same yaml file, an error will be returned. - - Labels cannot currently be set in the config.yaml; please use the - command-line flags to alter them. - - If an option is specified both in the configuration file and via - command-line arguments, the command-line arguments override the - configuration file. - - --description=DESCRIPTION - Description of the version. - - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - - --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. - - Configure request response logging. - - --bigquery-table-name=BIGQUERY_TABLE_NAME - Fully qualified name (project_id.dataset_name.table_name) of the - BigQuery table where requests and responses are logged. - - --sampling-percentage=SAMPLING_PERCENTAGE - Percentage of requests to be logged, expressed as a number between 0 - and 1. For example, set this value to 1 in order to log all requests - or to 0.1 to log 10% of requests. - - 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 ml-engine versions update --clear-labels - - To remove all existing labels and create two new labels, foo and baz: - - $ gcloud alpha ml-engine versions update --clear-labels \ - --update-labels foo=bar,baz=qux - - --remove-labels=[KEY,...] - List of label keys to remove. If a label does not exist it is - silently ignored. If --update-labels is also specified then - --update-labels is applied first. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -NOTES - This command is currently in alpha and might change without notice. If this - command fails with API permission errors despite specifying the correct - project, you might be trying to access an API with an invitation-only early - access allowlist. These variants are also available: - - $ gcloud ml-engine versions update - - $ gcloud beta ml-engine versions update - diff --git a/gcloud/alpha/netapp/volumes/create b/gcloud/alpha/netapp/volumes/create index 9da54b4d1..aeedddf49 100644 --- a/gcloud/alpha/netapp/volumes/create +++ b/gcloud/alpha/netapp/volumes/create @@ -39,6 +39,7 @@ SYNOPSIS [--snapshot-weekly=[day=DAY], [hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP]] [--source-snapshot=SOURCE_SNAPSHOT] + [--throughput-mibps=THROUGHPUT_MIBPS] [--tiering-policy=[tier-action=ENABLED|PAUSED,...]] [--unix-permissions=UNIX_PERMISSIONS] [GCLOUD_WIDE_FLAG ...] @@ -271,6 +272,9 @@ OPTIONAL FLAGS To set the snapshot attribute: ▸ provide the argument --source-snapshot on the command line. + --throughput-mibps=THROUGHPUT_MIBPS + The desired throughput of the volume in MiB/s. + --tiering-policy=[tier-action=ENABLED|PAUSED,...] Tiering Policy contains auto tiering policy on a volume. diff --git a/gcloud/alpha/netapp/volumes/update b/gcloud/alpha/netapp/volumes/update index fe1893287..0aac63eec 100644 --- a/gcloud/alpha/netapp/volumes/update +++ b/gcloud/alpha/netapp/volumes/update @@ -29,6 +29,7 @@ SYNOPSIS [--snapshot-weekly=[day=DAY], [hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP]] [--source-snapshot=SOURCE_SNAPSHOT] [--storage-pool=STORAGE_POOL] + [--throughput-mibps=THROUGHPUT_MIBPS] [--tiering-policy=[tier-action=ENABLED|PAUSED,...]] [--unix-permissions=UNIX_PERMISSIONS] [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] @@ -203,6 +204,9 @@ FLAGS To set the storage_pool attribute: ▸ provide the argument --storage-pool on the command line. + --throughput-mibps=THROUGHPUT_MIBPS + The desired throughput of the volume in MiB/s. + --tiering-policy=[tier-action=ENABLED|PAUSED,...] Tiering Policy contains auto tiering policy on a volume. diff --git a/gcloud/assured/workloads/list b/gcloud/assured/workloads/list index 5e41520cb..2da2ba15f 100644 --- a/gcloud/assured/workloads/list +++ b/gcloud/assured/workloads/list @@ -21,9 +21,8 @@ EXAMPLES ▪ returning no more than 30 results ▪ requesting 10 results at a time from the backend - $ gcloud assured workloads list \ - organizations/123/locations/us-central1 --limit=30 \ - --page-size=10 + $ gcloud assured workloads list --organization=123 \ + --location=us-central1 --limit=30 --page-size=10 REQUIRED FLAGS --location=LOCATION diff --git a/gcloud/backup-dr/backup-vaults/create b/gcloud/backup-dr/backup-vaults/create index 63ce4c3d5..ff3e9eee9 100644 --- a/gcloud/backup-dr/backup-vaults/create +++ b/gcloud/backup-dr/backup-vaults/create @@ -5,10 +5,9 @@ SYNOPSIS gcloud backup-dr backup-vaults create (BACKUP_VAULT : --location=LOCATION) --backup-min-enforced-retention=BACKUP_MIN_ENFORCED_RETENTION [--access-restriction=ACCESS_RESTRICTION; default="within-org"] - [--no-async] - [--backup-retention-inheritance=BACKUP_RETENTION_INHERITANCE] - [--description=DESCRIPTION] [--effective-time=EFFECTIVE_TIME] - [--labels=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] + [--no-async] [--description=DESCRIPTION] + [--effective-time=EFFECTIVE_TIME] [--labels=[KEY=VALUE,...]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Create a Backup and DR backup vault. @@ -100,16 +99,6 @@ OPTIONAL FLAGS --no-async Wait for the operation in progress to complete. - --backup-retention-inheritance=BACKUP_RETENTION_INHERITANCE - The inheritance mode for enforced retention end time of the backup - within this backup vault. Once set, the inheritance mode cannot be - changed. Default is inherit-vault-retention. If set to - inherit-vault-retention, the backup retention period will be inherited - from the backup vault. If set to match-backup-expire-time, the backup - retention period will be the same as the backup expiration time. - BACKUP_RETENTION_INHERITANCE must be one of: inherit-vault-retention, - match-backup-expire-time. - --description=DESCRIPTION Optional description for the backup vault (2048 characters or less). diff --git a/gcloud/beta/assured/workloads/list b/gcloud/beta/assured/workloads/list index 34f37cfaa..9561581b7 100644 --- a/gcloud/beta/assured/workloads/list +++ b/gcloud/beta/assured/workloads/list @@ -21,9 +21,8 @@ EXAMPLES ▪ returning no more than 30 results ▪ requesting 10 results at a time from the backend - $ gcloud beta assured workloads list \ - organizations/123/locations/us-central1 --limit=30 \ - --page-size=10 + $ gcloud beta assured workloads list --organization=123 \ + --location=us-central1 --limit=30 --page-size=10 REQUIRED FLAGS --location=LOCATION diff --git a/gcloud/beta/compute/advice/calendar-mode b/gcloud/beta/compute/advice/calendar-mode index 94bfa4356..562d81170 100644 --- a/gcloud/beta/compute/advice/calendar-mode +++ b/gcloud/beta/compute/advice/calendar-mode @@ -100,9 +100,7 @@ OPTIONAL FLAGS specify 1d2h3m4s for a duration of 1 day, 2 hours, 3 minutes, and 4 seconds. - See $ - gcloud topic datetimes for information on duration format. + See $ gcloud topic datetimes for information on duration formats. min The minimum duration of the Future Reservation. @@ -117,9 +115,8 @@ OPTIONAL FLAGS A time range for the end time of the Future Reservation. Defined as a list of key-value pairs. - The key is either "from" or "to", and the value is a datetime. See $ - gcloud topic datetimes for information on time formats. + The key is either "from" or "to", and the value is a datetime. See $ + gcloud topic datetimes for information on time formats. from The earliest possible end time for the reservation. @@ -165,9 +162,8 @@ OPTIONAL FLAGS A time range for the start time of the Future Reservation. Defined as a list of key-value pairs. - The key is either "from" or "to", and the value is a datetime. See $ - gcloud topic datetimes for information on time formats. + The key is either "from" or "to", and the value is a datetime. See $ + gcloud topic datetimes for information on time formats. from The earliest possible start time for the reservation. diff --git a/gcloud/beta/compute/firewall-policies/mirroring-rules/create b/gcloud/beta/compute/firewall-policies/mirroring-rules/create index 5971fa625..a297c1da3 100644 --- a/gcloud/beta/compute/firewall-policies/mirroring-rules/create +++ b/gcloud/beta/compute/firewall-policies/mirroring-rules/create @@ -5,9 +5,9 @@ NAME SYNOPSIS gcloud beta compute firewall-policies mirroring-rules create PRIORITY --action=ACTION --firewall-policy=FIREWALL_POLICY - [--description=DESCRIPTION] [--dest-ip-ranges=[DEST_IP_RANGE,...]] - [--direction=DIRECTION] [--[no-]disabled] - [--layer4-configs=[LAYER4_CONFIG,...]] [--organization=ORGANIZATION] + --layer4-configs=[LAYER4_CONFIG,...] [--description=DESCRIPTION] + [--dest-ip-ranges=[DEST_IP_RANGE,...]] [--direction=DIRECTION] + [--[no-]disabled] [--organization=ORGANIZATION] [--security-profile-group=SECURITY_PROFILE_GROUP] [--src-ip-ranges=[SRC_IP_RANGE,...]] [--target-resources=[TARGET_RESOURCES,...]] [GCLOUD_WIDE_FLAG ...] @@ -39,6 +39,10 @@ REQUIRED FLAGS Short name of the firewall policy into which the rule should be inserted. + --layer4-configs=[LAYER4_CONFIG,...] + A list of destination protocols and ports to which the firewall rule + will apply. + OPTIONAL FLAGS --description=DESCRIPTION An optional, textual description for the rule. @@ -54,10 +58,6 @@ OPTIONAL FLAGS Use this flag to disable the rule. Disabled rules will not affect traffic. Use --disabled to enable and --no-disabled to disable. - --layer4-configs=[LAYER4_CONFIG,...] - A list of destination protocols and ports to which the firewall rule - will apply. - --organization=ORGANIZATION Organization which the organization firewall policy belongs to. Must be set if FIREWALL_POLICY is short name. diff --git a/gcloud/beta/compute/firewall-policies/rules/create b/gcloud/beta/compute/firewall-policies/rules/create index c3189b61f..9422e037c 100644 --- a/gcloud/beta/compute/firewall-policies/rules/create +++ b/gcloud/beta/compute/firewall-policies/rules/create @@ -4,14 +4,15 @@ NAME SYNOPSIS gcloud beta compute firewall-policies rules create PRIORITY --action=ACTION - --firewall-policy=FIREWALL_POLICY [--description=DESCRIPTION] + --firewall-policy=FIREWALL_POLICY --layer4-configs=[LAYER4_CONFIG,...] + [--description=DESCRIPTION] [--dest-address-groups=[DEST_ADDRESS_GROUPS,...]] [--dest-fqdns=[DEST_FQDNS,...]] [--dest-ip-ranges=[DEST_IP_RANGE,...]] [--dest-network-type=DEST_NETWORK_TYPE] [--dest-region-codes=[DEST_REGION_CODES,...]] [--dest-threat-intelligence=[DEST_THREAT_INTELLIGENCE_LISTS,...]] [--direction=DIRECTION] [--[no-]disabled] [--[no-]enable-logging] - [--layer4-configs=[LAYER4_CONFIG,...]] [--organization=ORGANIZATION] + [--organization=ORGANIZATION] [--security-profile-group=SECURITY_PROFILE_GROUP] [--src-address-groups=[SOURCE_ADDRESS_GROUPS,...]] [--src-fqdns=[SOURCE_FQDNS,...]] [--src-ip-ranges=[SRC_IP_RANGE,...]] @@ -50,6 +51,10 @@ REQUIRED FLAGS Short name of the firewall policy into which the rule should be inserted. + --layer4-configs=[LAYER4_CONFIG,...] + A list of destination protocols and ports to which the firewall rule + will apply. + OPTIONAL FLAGS --description=DESCRIPTION An optional, textual description for the rule. @@ -95,10 +100,6 @@ OPTIONAL FLAGS by this rule. Use --enable-logging to enable and --no-enable-logging to disable. - --layer4-configs=[LAYER4_CONFIG,...] - A list of destination protocols and ports to which the firewall rule - will apply. - --organization=ORGANIZATION Organization which the organization firewall policy belongs to. Must be set if FIREWALL_POLICY is short name. diff --git a/gcloud/beta/compute/instance-groups/managed/create b/gcloud/beta/compute/instance-groups/managed/create index dad9f41be..e1d9bb7a3 100644 --- a/gcloud/beta/compute/instance-groups/managed/create +++ b/gcloud/beta/compute/instance-groups/managed/create @@ -24,6 +24,7 @@ SYNOPSIS [auto-delete=AUTO-DELETE],[interface-name=INTERFACE-NAME]] [--stopped-size=STOPPED_SIZE] [--suspended-size=SUSPENDED_SIZE] [--target-distribution-shape=SHAPE] [--target-pool=[TARGET_POOL,...]] + [--target-size-policy-mode=TARGET_SIZE_POLICY_MODE] [--workload-policy=WORKLOAD_POLICY] [--zones=ZONE,[ZONE,...]] [--health-check=HEALTH_CHECK | --http-health-check=HTTP_HEALTH_CHECK | --https-health-check=HTTPS_HEALTH_CHECK] @@ -326,6 +327,20 @@ OPTIONAL FLAGS Specifies any target pools you want the instances of this managed instance group to be part of. + --target-size-policy-mode=TARGET_SIZE_POLICY_MODE + Specifies the mode in which the MIG creates VMs in the group. + TARGET_SIZE_POLICY_MODE must be one of: + + bulk + MIG creates VMs all at once. If the MIG cannot create any VM to + meet the specified ``size``, then the MIG waits until the resources + become available to create all VMs. + individual + (Default) MIG creates VMs individually. If the MIG cannot create + any VM to meet the specified ``size``, then the MIG creates the VMs + for which resources are available. The MIG then attempts to create + the remaining VMs until the resources become available. + --workload-policy=WORKLOAD_POLICY Specifies the workload policy for the managed instance group. It can be a full or partial URL to a resource policy containing the workload diff --git a/gcloud/beta/compute/instance-templates/create b/gcloud/beta/compute/instance-templates/create index 99ad8db63..c2eb15828 100644 --- a/gcloud/beta/compute/instance-templates/create +++ b/gcloud/beta/compute/instance-templates/create @@ -52,7 +52,8 @@ SYNOPSIS [--resource-manager-tags=[KEY=VALUE,...]] [--resource-policies=[RESOURCE_POLICY,...]] [--no-restart-on-failure] [--shielded-integrity-monitoring] [--shielded-secure-boot] - [--shielded-vtpm] [--source-instance=SOURCE_INSTANCE] + [--shielded-vtpm] [--[no-]skip-guest-os-shutdown] + [--source-instance=SOURCE_INSTANCE] [--source-instance-zone=SOURCE_INSTANCE_ZONE] [--stack-type=STACK_TYPE] [--subnet=SUBNET] [--tags=TAG,[TAG,...]] [--termination-time=TERMINATION_TIME] @@ -923,6 +924,12 @@ FLAGS about how to modify Shielded VM options, see https://cloud.google.com/compute/docs/instances/modifying-shielded-vm. + --[no-]skip-guest-os-shutdown + If enabled, then, when the instance is stopped or deleted, the instance + is immediately stopped without giving time to the guest OS to cleanly + shut down. Use --skip-guest-os-shutdown to enable and + --no-skip-guest-os-shutdown to disable. + --source-instance=SOURCE_INSTANCE The name of the source instance that the instance template will be created from. diff --git a/gcloud/beta/compute/instance-templates/create-with-container b/gcloud/beta/compute/instance-templates/create-with-container index c25636c54..e21913365 100644 --- a/gcloud/beta/compute/instance-templates/create-with-container +++ b/gcloud/beta/compute/instance-templates/create-with-container @@ -44,8 +44,9 @@ SYNOPSIS [--provisioning-model=PROVISIONING_MODEL] [--region=REGION] [--resource-policies=[RESOURCE_POLICY,...]] [--no-restart-on-failure] [--shielded-integrity-monitoring] [--shielded-secure-boot] - [--shielded-vtpm] [--stack-type=STACK_TYPE] [--subnet=SUBNET] - [--tags=TAG,[TAG,...]] [--address=ADDRESS | --no-address] + [--shielded-vtpm] [--[no-]skip-guest-os-shutdown] + [--stack-type=STACK_TYPE] [--subnet=SUBNET] [--tags=TAG,[TAG,...]] + [--address=ADDRESS | --no-address] [--custom-cpu=CUSTOM_CPU --custom-memory=CUSTOM_MEMORY : --custom-extensions --custom-vm-type=CUSTOM_VM_TYPE] [--image-project=IMAGE_PROJECT --image=IMAGE @@ -770,6 +771,12 @@ FLAGS about how to modify Shielded VM options, see https://cloud.google.com/compute/docs/instances/modifying-shielded-vm. + --[no-]skip-guest-os-shutdown + If enabled, then, when the instance is stopped or deleted, the instance + is immediately stopped without giving time to the guest OS to cleanly + shut down. Use --skip-guest-os-shutdown to enable and + --no-skip-guest-os-shutdown to disable. + --stack-type=STACK_TYPE Specifies whether IPv6 is enabled on the default network interface. If not specified, IPV4_ONLY will be used. STACK_TYPE must be one of: diff --git a/gcloud/beta/compute/instances/bulk/create b/gcloud/beta/compute/instances/bulk/create index e6288fd1c..c09d4103e 100644 --- a/gcloud/beta/compute/instances/bulk/create +++ b/gcloud/beta/compute/instances/bulk/create @@ -45,7 +45,8 @@ SYNOPSIS [--resource-manager-tags=[KEY=VALUE,...]] [--resource-policies=[RESOURCE_POLICY,...]] [--no-restart-on-failure] [--shielded-integrity-monitoring] [--shielded-secure-boot] - [--shielded-vtpm] [--source-instance-template=SOURCE_INSTANCE_TEMPLATE] + [--shielded-vtpm] [--[no-]skip-guest-os-shutdown] + [--source-instance-template=SOURCE_INSTANCE_TEMPLATE] [--stack-type=STACK_TYPE] [--subnet=SUBNET] [--tags=TAG,[TAG,...]] [--target-distribution-shape=SHAPE] [--termination-time=TERMINATION_TIME] @@ -777,6 +778,12 @@ OPTIONAL FLAGS about how to modify Shielded VM options, see https://cloud.google.com/compute/docs/instances/modifying-shielded-vm. + --[no-]skip-guest-os-shutdown + If enabled, then, when the instance is stopped or deleted, the instance + is immediately stopped without giving time to the guest OS to cleanly + shut down. Use --skip-guest-os-shutdown to enable and + --no-skip-guest-os-shutdown to disable. + --source-instance-template=SOURCE_INSTANCE_TEMPLATE The name of the instance template that the instance will be created from. Users can override fields by specifying other flags. diff --git a/gcloud/beta/compute/instances/create b/gcloud/beta/compute/instances/create index c835b5ea0..e2f93f7d8 100644 --- a/gcloud/beta/compute/instances/create +++ b/gcloud/beta/compute/instances/create @@ -55,7 +55,8 @@ SYNOPSIS [--resource-manager-tags=[KEY=VALUE,...]] [--resource-policies=[RESOURCE_POLICY,...]] [--no-restart-on-failure] [--shielded-integrity-monitoring] [--shielded-secure-boot] - [--shielded-vtpm] [--source-instance-template=SOURCE_INSTANCE_TEMPLATE] + [--shielded-vtpm] [--[no-]skip-guest-os-shutdown] + [--source-instance-template=SOURCE_INSTANCE_TEMPLATE] [--source-machine-image=SOURCE_MACHINE_IMAGE] [--source-machine-image-csek-key-file=FILE] [--stack-type=STACK_TYPE] [--subnet=SUBNET] [--tags=TAG,[TAG,...]] @@ -985,6 +986,12 @@ FLAGS about how to modify Shielded VM options, see https://cloud.google.com/compute/docs/instances/modifying-shielded-vm. + --[no-]skip-guest-os-shutdown + If enabled, then, when the instance is stopped or deleted, the instance + is immediately stopped without giving time to the guest OS to cleanly + shut down. Use --skip-guest-os-shutdown to enable and + --no-skip-guest-os-shutdown to disable. + --source-instance-template=SOURCE_INSTANCE_TEMPLATE The name of the instance template that the instance will be created from. An instance template can be a global/regional resource. diff --git a/gcloud/beta/compute/instances/create-with-container b/gcloud/beta/compute/instances/create-with-container index 08a674a99..7b42e6fc6 100644 --- a/gcloud/beta/compute/instances/create-with-container +++ b/gcloud/beta/compute/instances/create-with-container @@ -54,7 +54,8 @@ SYNOPSIS [--provisioning-model=PROVISIONING_MODEL] [--resource-policies=[RESOURCE_POLICY,...]] [--no-restart-on-failure] [--shielded-integrity-monitoring] [--shielded-secure-boot] - [--shielded-vtpm] [--source-instance-template=SOURCE_INSTANCE_TEMPLATE] + [--shielded-vtpm] [--[no-]skip-guest-os-shutdown] + [--source-instance-template=SOURCE_INSTANCE_TEMPLATE] [--stack-type=STACK_TYPE] [--subnet=SUBNET] [--tags=TAG,[TAG,...]] [--termination-time=TERMINATION_TIME] [--threads-per-core=THREADS_PER_CORE] @@ -856,6 +857,12 @@ FLAGS about how to modify Shielded VM options, see https://cloud.google.com/compute/docs/instances/modifying-shielded-vm. + --[no-]skip-guest-os-shutdown + If enabled, then, when the instance is stopped or deleted, the instance + is immediately stopped without giving time to the guest OS to cleanly + shut down. Use --skip-guest-os-shutdown to enable and + --no-skip-guest-os-shutdown to disable. + --source-instance-template=SOURCE_INSTANCE_TEMPLATE The name of the instance template that the instance will be created from. An instance template can be a global/regional resource. diff --git a/gcloud/beta/compute/instances/set-scheduling b/gcloud/beta/compute/instances/set-scheduling index ccb6cd6ad..90dca44b3 100644 --- a/gcloud/beta/compute/instances/set-scheduling +++ b/gcloud/beta/compute/instances/set-scheduling @@ -10,7 +10,8 @@ SYNOPSIS [--local-ssd-recovery-timeout=LOCAL_SSD_RECOVERY_TIMEOUT] [--maintenance-policy=MAINTENANCE_POLICY] [--min-node-cpu=MIN_NODE_CPU] [--[no-]preemptible] [--provisioning-model=PROVISIONING_MODEL] - [--[no-]restart-on-failure] [--zone=ZONE] + [--[no-]restart-on-failure] [--[no-]skip-guest-os-shutdown] + [--zone=ZONE] [--clear-discard-local-ssds-at-termination-timestamp | --discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP] [--clear-instance-termination-action @@ -115,6 +116,12 @@ FLAGS option is mutually exclusive with --preemptible. Use --restart-on-failure to enable and --no-restart-on-failure to disable. + --[no-]skip-guest-os-shutdown + If enabled, then, when the instance is stopped or deleted, the instance + is immediately stopped without giving time to the guest OS to cleanly + shut down. Use --skip-guest-os-shutdown to enable and + --no-skip-guest-os-shutdown to disable. + --zone=ZONE Zone of the instance to operate on. If not specified, you might be prompted to select a zone (interactive mode only). gcloud attempts to diff --git a/gcloud/beta/compute/interconnects/application-awareness/configure-bandwidth-percentage-policy b/gcloud/beta/compute/interconnects/application-awareness/configure-bandwidth-percentage-policy index 62b3fefa7..411ad6577 100644 --- a/gcloud/beta/compute/interconnects/application-awareness/configure-bandwidth-percentage-policy +++ b/gcloud/beta/compute/interconnects/application-awareness/configure-bandwidth-percentage-policy @@ -23,8 +23,8 @@ EXAMPLES example-interconnect, run: $ gcloud beta compute interconnects application-awareness \ configure-bandwidth-percentage-policy example-interconnect \ - --bandwidth-percentages="TC1=11,TC2=10" --enabled \ - --profile_description="some string " + --bandwidth-percentages="TC1=5,TC2=5,TC3=75,TC4=5,TC5=5,TC6=5" \ + --enabled --profile_description="some string" POSITIONAL ARGUMENTS NAME @@ -32,8 +32,21 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --bandwidth-percentages=[TC1=TC1],[TC2=TC2],[TC3=TC3],[TC4=TC4],[TC5=TC5],[TC6=TC6] - A list of bandwidth percentages for each application awareness profile. - The sum of all bandwidth percentages must be 100. + A list of bandwidth percentages, for configuring the bandwidth + percentage policy or traffic shaping. + + For configuring bandwidth percentages for the bandwidth percentage + policy: + + 1. Each bandwidth percentage value must be an integer between 1-100. 2. + It is required to provide a percentage value for each class. 3. The sum + of all bandwidth percentages must be 100. + + For configuring bandwidth percentages for traffic shaping: + + 1. Each bandwidth percentage value must be an integer between 1-100. 2. + It is not required to provide a percentage value for each class. 3. The + sum of all bandwidth percentages does not need to be 100. OPTIONAL FLAGS --enabled diff --git a/gcloud/beta/compute/interconnects/application-awareness/configure-shaper-average-percentage b/gcloud/beta/compute/interconnects/application-awareness/configure-shaper-average-percentage index 132c1c11c..1bf9aeb1b 100644 --- a/gcloud/beta/compute/interconnects/application-awareness/configure-shaper-average-percentage +++ b/gcloud/beta/compute/interconnects/application-awareness/configure-shaper-average-percentage @@ -14,7 +14,9 @@ SYNOPSIS DESCRIPTION (BETA) gcloud beta compute interconnects application-awareness configure-shaper-average-percentage is used to configure shaper average - percentage for using application awareness on interconnect. + percentage for using application awareness on interconnect. Note that an + application awareness policy (strict priority or bandwidth percentage) + should be configure before configuring traffic shaping. For an example, refer to the EXAMPLES section below. @@ -23,8 +25,8 @@ EXAMPLES example-interconnect, run: $ gcloud beta compute interconnects application-awareness \ configure-shaper-average-percentage example-interconnect \ - --bandwidth-percentages="TC1=11,TC2=10" --enabled \ - --profile_description="some string " + --bandwidth-percentages="TC1=30,TC2=90" --enabled \ + --profile_description="some string" POSITIONAL ARGUMENTS NAME @@ -32,8 +34,21 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --bandwidth-percentages=[TC1=TC1],[TC2=TC2],[TC3=TC3],[TC4=TC4],[TC5=TC5],[TC6=TC6] - A list of bandwidth percentages for each application awareness profile. - The sum of all bandwidth percentages must be 100. + A list of bandwidth percentages, for configuring the bandwidth + percentage policy or traffic shaping. + + For configuring bandwidth percentages for the bandwidth percentage + policy: + + 1. Each bandwidth percentage value must be an integer between 1-100. 2. + It is required to provide a percentage value for each class. 3. The sum + of all bandwidth percentages must be 100. + + For configuring bandwidth percentages for traffic shaping: + + 1. Each bandwidth percentage value must be an integer between 1-100. 2. + It is not required to provide a percentage value for each class. 3. The + sum of all bandwidth percentages does not need to be 100. OPTIONAL FLAGS --enabled diff --git a/gcloud/beta/compute/network-firewall-policies/mirroring-rules/create b/gcloud/beta/compute/network-firewall-policies/mirroring-rules/create index d152b3d7a..ffba6bc34 100644 --- a/gcloud/beta/compute/network-firewall-policies/mirroring-rules/create +++ b/gcloud/beta/compute/network-firewall-policies/mirroring-rules/create @@ -5,9 +5,9 @@ NAME SYNOPSIS gcloud beta compute network-firewall-policies mirroring-rules create PRIORITY --action=ACTION --firewall-policy=FIREWALL_POLICY - --global-firewall-policy [--description=DESCRIPTION] - [--dest-ip-ranges=[DEST_IP_RANGE,...]] [--direction=DIRECTION] - [--[no-]disabled] [--layer4-configs=[LAYER4_CONFIG,...]] + --global-firewall-policy --layer4-configs=[LAYER4_CONFIG,...] + [--description=DESCRIPTION] [--dest-ip-ranges=[DEST_IP_RANGE,...]] + [--direction=DIRECTION] [--[no-]disabled] [--security-profile-group=SECURITY_PROFILE_GROUP] [--src-ip-ranges=[SRC_IP_RANGE,...]] [--target-secure-tags=[TARGET_SECURE_TAGS,...]] [GCLOUD_WIDE_FLAG ...] @@ -39,6 +39,10 @@ REQUIRED FLAGS --global-firewall-policy Use this flag to indicate that firewall policy is global. + --layer4-configs=[LAYER4_CONFIG,...] + A list of destination protocols and ports to which the firewall rule + will apply. + OPTIONAL FLAGS --description=DESCRIPTION An optional, textual description for the rule. @@ -54,10 +58,6 @@ OPTIONAL FLAGS Use this flag to disable the rule. Disabled rules will not affect traffic. Use --disabled to enable and --no-disabled to disable. - --layer4-configs=[LAYER4_CONFIG,...] - A list of destination protocols and ports to which the firewall rule - will apply. - --security-profile-group=SECURITY_PROFILE_GROUP A security profile group to be used with mirror action. diff --git a/gcloud/beta/compute/network-firewall-policies/rules/create b/gcloud/beta/compute/network-firewall-policies/rules/create index 93795cabd..0a9afb6c7 100644 --- a/gcloud/beta/compute/network-firewall-policies/rules/create +++ b/gcloud/beta/compute/network-firewall-policies/rules/create @@ -5,14 +5,13 @@ NAME SYNOPSIS gcloud beta compute network-firewall-policies rules create PRIORITY --action=ACTION --firewall-policy=FIREWALL_POLICY - [--description=DESCRIPTION] + --layer4-configs=[LAYER4_CONFIG,...] [--description=DESCRIPTION] [--dest-address-groups=[DEST_ADDRESS_GROUPS,...]] [--dest-fqdns=[DEST_FQDNS,...]] [--dest-ip-ranges=[DEST_IP_RANGE,...]] [--dest-network-type=DEST_NETWORK_TYPE] [--dest-region-codes=[DEST_REGION_CODES,...]] [--dest-threat-intelligence=[DEST_THREAT_INTELLIGENCE_LISTS,...]] [--direction=DIRECTION] [--[no-]disabled] [--[no-]enable-logging] - [--layer4-configs=[LAYER4_CONFIG,...]] [--security-profile-group=SECURITY_PROFILE_GROUP] [--src-address-groups=[SOURCE_ADDRESS_GROUPS,...]] [--src-fqdns=[SOURCE_FQDNS,...]] [--src-ip-ranges=[SRC_IP_RANGE,...]] @@ -59,6 +58,10 @@ REQUIRED FLAGS --firewall-policy=FIREWALL_POLICY Firewall policy ID with which to create rule. + --layer4-configs=[LAYER4_CONFIG,...] + A list of destination protocols and ports to which the firewall rule + will apply. + OPTIONAL FLAGS --description=DESCRIPTION An optional, textual description for the rule. @@ -104,10 +107,6 @@ OPTIONAL FLAGS by this rule. Use --enable-logging to enable and --no-enable-logging to disable. - --layer4-configs=[LAYER4_CONFIG,...] - A list of destination protocols and ports to which the firewall rule - will apply. - --security-profile-group=SECURITY_PROFILE_GROUP A security profile group to be used with apply_security_profile_group action. diff --git a/gcloud/beta/compute/networks/subnets/describe b/gcloud/beta/compute/networks/subnets/describe index 665984461..6860623eb 100644 --- a/gcloud/beta/compute/networks/subnets/describe +++ b/gcloud/beta/compute/networks/subnets/describe @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud beta compute networks subnets describe NAME [--region=REGION] - [GCLOUD_WIDE_FLAG ...] + [--view=VIEW] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) gcloud beta compute networks subnets describe displays all data @@ -40,6 +40,14 @@ FLAGS Alternatively, the region can be stored in the environment variable CLOUDSDK_COMPUTE_REGION. + --view=VIEW + Specifies the information that the output should contain. VIEW must be + (only one value is supported): + + WITH_UTILIZATION + Output includes the IP utilization data of all subnetwork ranges, + showing total allocated and free IPv4 and IPv6 IPs. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/beta/compute/networks/subnets/list b/gcloud/beta/compute/networks/subnets/list index 015a49ed8..102b27f26 100644 --- a/gcloud/beta/compute/networks/subnets/list +++ b/gcloud/beta/compute/networks/subnets/list @@ -5,8 +5,9 @@ NAME SYNOPSIS gcloud beta compute networks subnets list [NAME ...] [--network=NETWORK] [--regexp=REGEXP, -r REGEXP] [--regions=REGION,[REGION,...]] - [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] - [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + [--view=VIEW] [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) gcloud beta compute networks subnets list displays all Google @@ -51,6 +52,14 @@ FLAGS --regions=REGION,[REGION,...] If provided, only resources from the given regions are queried. + --view=VIEW + Specifies the information that the output should contain. VIEW must be + (only one value is supported): + + WITH_UTILIZATION + Output includes the IP utilization data of all subnetwork ranges, + showing total allocated and free IPv4 and IPv6 IPs. + LIST COMMAND FLAGS --filter=EXPRESSION Apply a Boolean filter EXPRESSION to each resource item to be listed. diff --git a/gcloud/beta/compute/preview-features/update b/gcloud/beta/compute/preview-features/update index d746f7ae6..982145e47 100644 --- a/gcloud/beta/compute/preview-features/update +++ b/gcloud/beta/compute/preview-features/update @@ -12,8 +12,8 @@ DESCRIPTION (BETA) Update a preview feature's activation status. EXAMPLES - To enable/disable a preview feature's activation status, run the following - command: + To enable/unspecify a preview feature's activation status, run the + following command: $ gcloud beta compute preview-features update @@ -40,7 +40,7 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --activation-status=ACTIVATION_STATUS The activation status of the preview feature. ACTIVATION_STATUS must be - one of: disabled, enabled. + one of: enabled, unspecified. The rollout plan of the preview feature. diff --git a/gcloud/beta/container/fleet/config-management/disable b/gcloud/beta/container/fleet/config-management/disable index 64d54d2dc..1f0034d70 100644 --- a/gcloud/beta/container/fleet/config-management/disable +++ b/gcloud/beta/container/fleet/config-management/disable @@ -1,40 +1,102 @@ NAME - gcloud beta container fleet config-management disable - disable Config + gcloud beta container fleet config-management disable - disable the Config Management feature SYNOPSIS - gcloud beta container fleet config-management disable - [--fleet-default-member-config | --force] [GCLOUD_WIDE_FLAG ...] + gcloud beta container fleet config-management disable [--force] + [--fleet-default-member-config | --uninstall --all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Disable the Config Management feature in a fleet. Disable the - feature entirely or only disable fleet-default membership configuration - (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features) - for the feature. + (BETA) Disable the Config Management feature entirely, or disable specific + configuration on the feature. + + gcloud beta container fleet config-management disable without flags deletes + the Config Management feature, which unmanages and leaves existing Config + Sync installations on membership clusters. Running the command without + flags exits silently if the feature does not exist. Specify flags to + disable configuration on parts of the feature without deleting it. EXAMPLES To disable the Config Management feature entirely, run: $ gcloud beta container fleet config-management disable - To disable only fleet-default membership configuration for the feature, - run: + To unmanage Config Sync only on select memberships, run: $ gcloud beta container fleet config-management disable \ - --fleet-default-member-config + --memberships=example-membership-1,example-membership-2 FLAGS + --force + Force disablement. Bypasses any prompts for confirmation. When + disabling the entire feature, proceeds even if the feature is in use. + Might result in unexpected behavior. + At most one of these can be specified: --fleet-default-member-config Disable the fleet-default membership configuration (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features). - Does not change existing membership configurations. + Does not change existing membership configurations. Does nothing if + the feature is disabled. - --force - Force disablement. Bypasses any prompts for confirmation. When - disabling the entire feature, proceeds even if the feature is in use. - Might result in unexpected behavior. + Membership-specific flags. In the absence of --uninstall, using either + --memberships or --all-memberships removes the entire configuration for + the specified memberships, which unmanages and leaves existing Config + Sync installations on the membership clusters. Unmanagement does not + error if the feature is disabled. + + --uninstall + Uninstall any previously-installed and managed Config Sync on the + specified memberships by setting the enabled field + (https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/reference/gcloud-apply-fields) + to false. Clears all other configuration for each membership. Does + not wait for the uninstallation to complete. To bypass the + confirmation prompt, use --force. Requires the feature to be + enabled. + + To uninstall Config Sync on select memberships, run: + + $ gcloud beta container fleet config-management disable \ + --uninstall \ + --memberships=example-membership-1,example-membership-2 + + At most one of these can be specified: + + --all-memberships + All 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, diff --git a/gcloud/beta/container/fleet/config-management/help b/gcloud/beta/container/fleet/config-management/help index ab7f9b4d3..e994290db 100644 --- a/gcloud/beta/container/fleet/config-management/help +++ b/gcloud/beta/container/fleet/config-management/help @@ -24,7 +24,7 @@ COMMANDS (BETA) Update a Config Management feature spec. disable - (BETA) Disable Config Management feature. + (BETA) Disable the Config Management feature. enable (BETA) Enable Config Management feature. diff --git a/gcloud/beta/container/fleet/packages/create b/gcloud/beta/container/fleet/packages/create index ffba482e8..42859746e 100644 --- a/gcloud/beta/container/fleet/packages/create +++ b/gcloud/beta/container/fleet/packages/create @@ -36,8 +36,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container fleet packages create $ gcloud alpha container fleet packages create diff --git a/gcloud/beta/container/fleet/packages/delete b/gcloud/beta/container/fleet/packages/delete index 8c0a69491..7ad658dc5 100644 --- a/gcloud/beta/container/fleet/packages/delete +++ b/gcloud/beta/container/fleet/packages/delete @@ -61,8 +61,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container fleet packages delete $ gcloud alpha container fleet packages delete diff --git a/gcloud/beta/container/fleet/packages/describe b/gcloud/beta/container/fleet/packages/describe index e4ae00e7c..d4e45ae5c 100644 --- a/gcloud/beta/container/fleet/packages/describe +++ b/gcloud/beta/container/fleet/packages/describe @@ -61,8 +61,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container fleet packages describe $ gcloud alpha container fleet packages describe diff --git a/gcloud/beta/container/fleet/packages/help b/gcloud/beta/container/fleet/packages/help index 08522bf96..255dd6f37 100644 --- a/gcloud/beta/container/fleet/packages/help +++ b/gcloud/beta/container/fleet/packages/help @@ -40,8 +40,10 @@ COMMANDS (BETA) Update Package Rollouts Fleet Package. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container fleet packages $ gcloud alpha container fleet packages diff --git a/gcloud/beta/container/fleet/packages/list b/gcloud/beta/container/fleet/packages/list index b9c9dbfa3..8a68da19f 100644 --- a/gcloud/beta/container/fleet/packages/list +++ b/gcloud/beta/container/fleet/packages/list @@ -60,8 +60,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container fleet packages list $ gcloud alpha container fleet packages list diff --git a/gcloud/beta/container/fleet/packages/resource-bundles/create b/gcloud/beta/container/fleet/packages/resource-bundles/create index 6cd5924ef..33b519591 100644 --- a/gcloud/beta/container/fleet/packages/resource-bundles/create +++ b/gcloud/beta/container/fleet/packages/resource-bundles/create @@ -36,8 +36,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container fleet packages resource-bundles create $ gcloud alpha container fleet packages resource-bundles create diff --git a/gcloud/beta/container/fleet/packages/resource-bundles/delete b/gcloud/beta/container/fleet/packages/resource-bundles/delete index ec90e9621..0d688d625 100644 --- a/gcloud/beta/container/fleet/packages/resource-bundles/delete +++ b/gcloud/beta/container/fleet/packages/resource-bundles/delete @@ -36,8 +36,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container fleet packages resource-bundles delete $ gcloud alpha container fleet packages resource-bundles delete diff --git a/gcloud/beta/container/fleet/packages/resource-bundles/describe b/gcloud/beta/container/fleet/packages/resource-bundles/describe index c85f743ed..b3e60cd64 100644 --- a/gcloud/beta/container/fleet/packages/resource-bundles/describe +++ b/gcloud/beta/container/fleet/packages/resource-bundles/describe @@ -32,8 +32,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container fleet packages resource-bundles describe $ gcloud alpha container fleet packages resource-bundles describe diff --git a/gcloud/beta/container/fleet/packages/resource-bundles/help b/gcloud/beta/container/fleet/packages/resource-bundles/help index 53c830b22..230661e12 100644 --- a/gcloud/beta/container/fleet/packages/resource-bundles/help +++ b/gcloud/beta/container/fleet/packages/resource-bundles/help @@ -40,8 +40,10 @@ COMMANDS (BETA) Update Package Rollouts Resource Bundle. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container fleet packages resource-bundles $ gcloud alpha container fleet packages resource-bundles diff --git a/gcloud/beta/container/fleet/packages/resource-bundles/list b/gcloud/beta/container/fleet/packages/resource-bundles/list index dc74db411..07af70fde 100644 --- a/gcloud/beta/container/fleet/packages/resource-bundles/list +++ b/gcloud/beta/container/fleet/packages/resource-bundles/list @@ -62,8 +62,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container fleet packages resource-bundles list $ gcloud alpha container fleet packages resource-bundles list diff --git a/gcloud/beta/container/fleet/packages/resource-bundles/releases/create b/gcloud/beta/container/fleet/packages/resource-bundles/releases/create index 832d12920..d22df2ba9 100644 --- a/gcloud/beta/container/fleet/packages/resource-bundles/releases/create +++ b/gcloud/beta/container/fleet/packages/resource-bundles/releases/create @@ -66,8 +66,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container fleet packages resource-bundles releases create $ gcloud alpha container fleet packages resource-bundles releases \ create diff --git a/gcloud/beta/container/fleet/packages/resource-bundles/releases/delete b/gcloud/beta/container/fleet/packages/resource-bundles/releases/delete index 07f47e287..2dfea9bf9 100644 --- a/gcloud/beta/container/fleet/packages/resource-bundles/releases/delete +++ b/gcloud/beta/container/fleet/packages/resource-bundles/releases/delete @@ -42,8 +42,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container fleet packages resource-bundles releases delete $ gcloud alpha container fleet packages resource-bundles releases \ delete diff --git a/gcloud/beta/container/fleet/packages/resource-bundles/releases/describe b/gcloud/beta/container/fleet/packages/resource-bundles/releases/describe index 8043df294..1d69e8ff3 100644 --- a/gcloud/beta/container/fleet/packages/resource-bundles/releases/describe +++ b/gcloud/beta/container/fleet/packages/resource-bundles/releases/describe @@ -38,8 +38,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container fleet packages resource-bundles releases describe $ gcloud alpha container fleet packages resource-bundles releases \ describe diff --git a/gcloud/beta/container/fleet/packages/resource-bundles/releases/help b/gcloud/beta/container/fleet/packages/resource-bundles/releases/help index 3336db362..9295ebc29 100644 --- a/gcloud/beta/container/fleet/packages/resource-bundles/releases/help +++ b/gcloud/beta/container/fleet/packages/resource-bundles/releases/help @@ -34,8 +34,10 @@ COMMANDS (BETA) Update Package Rollouts Release. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container fleet packages resource-bundles releases $ gcloud alpha container fleet packages resource-bundles releases diff --git a/gcloud/beta/container/fleet/packages/resource-bundles/releases/list b/gcloud/beta/container/fleet/packages/resource-bundles/releases/list index 0decf5c13..ee17f47af 100644 --- a/gcloud/beta/container/fleet/packages/resource-bundles/releases/list +++ b/gcloud/beta/container/fleet/packages/resource-bundles/releases/list @@ -66,8 +66,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container fleet packages resource-bundles releases list $ gcloud alpha container fleet packages resource-bundles releases \ list diff --git a/gcloud/beta/container/fleet/packages/resource-bundles/releases/update b/gcloud/beta/container/fleet/packages/resource-bundles/releases/update index 1cdff7c20..1a6ee3f53 100644 --- a/gcloud/beta/container/fleet/packages/resource-bundles/releases/update +++ b/gcloud/beta/container/fleet/packages/resource-bundles/releases/update @@ -41,8 +41,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container fleet packages resource-bundles releases update $ gcloud alpha container fleet packages resource-bundles releases \ update diff --git a/gcloud/beta/container/fleet/packages/resource-bundles/update b/gcloud/beta/container/fleet/packages/resource-bundles/update index 75c7a66e7..47f36c13e 100644 --- a/gcloud/beta/container/fleet/packages/resource-bundles/update +++ b/gcloud/beta/container/fleet/packages/resource-bundles/update @@ -36,8 +36,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container fleet packages resource-bundles update $ gcloud alpha container fleet packages resource-bundles update diff --git a/gcloud/beta/container/fleet/packages/rollouts/abort b/gcloud/beta/container/fleet/packages/rollouts/abort index b40c6c78c..dc41f7eaa 100644 --- a/gcloud/beta/container/fleet/packages/rollouts/abort +++ b/gcloud/beta/container/fleet/packages/rollouts/abort @@ -67,8 +67,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container fleet packages rollouts abort $ gcloud alpha container fleet packages rollouts abort diff --git a/gcloud/beta/container/fleet/packages/rollouts/describe b/gcloud/beta/container/fleet/packages/rollouts/describe index 19af2d308..501778add 100644 --- a/gcloud/beta/container/fleet/packages/rollouts/describe +++ b/gcloud/beta/container/fleet/packages/rollouts/describe @@ -40,8 +40,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container fleet packages rollouts describe $ gcloud alpha container fleet packages rollouts describe diff --git a/gcloud/beta/container/fleet/packages/rollouts/help b/gcloud/beta/container/fleet/packages/rollouts/help index 79bf21eb8..6f91b77bd 100644 --- a/gcloud/beta/container/fleet/packages/rollouts/help +++ b/gcloud/beta/container/fleet/packages/rollouts/help @@ -33,8 +33,10 @@ COMMANDS (BETA) Suspend in-progress Rollout. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container fleet packages rollouts $ gcloud alpha container fleet packages rollouts diff --git a/gcloud/beta/container/fleet/packages/rollouts/list b/gcloud/beta/container/fleet/packages/rollouts/list index f4d1a985a..514e838a7 100644 --- a/gcloud/beta/container/fleet/packages/rollouts/list +++ b/gcloud/beta/container/fleet/packages/rollouts/list @@ -70,8 +70,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container fleet packages rollouts list $ gcloud alpha container fleet packages rollouts list diff --git a/gcloud/beta/container/fleet/packages/rollouts/resume b/gcloud/beta/container/fleet/packages/rollouts/resume index 23103647a..e1b214369 100644 --- a/gcloud/beta/container/fleet/packages/rollouts/resume +++ b/gcloud/beta/container/fleet/packages/rollouts/resume @@ -67,8 +67,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container fleet packages rollouts resume $ gcloud alpha container fleet packages rollouts resume diff --git a/gcloud/beta/container/fleet/packages/rollouts/suspend b/gcloud/beta/container/fleet/packages/rollouts/suspend index b871f2693..e368d893f 100644 --- a/gcloud/beta/container/fleet/packages/rollouts/suspend +++ b/gcloud/beta/container/fleet/packages/rollouts/suspend @@ -67,8 +67,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container fleet packages rollouts suspend $ gcloud alpha container fleet packages rollouts suspend diff --git a/gcloud/beta/container/fleet/packages/update b/gcloud/beta/container/fleet/packages/update index d7ea3c8f5..cec284b0e 100644 --- a/gcloud/beta/container/fleet/packages/update +++ b/gcloud/beta/container/fleet/packages/update @@ -61,8 +61,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container fleet packages update $ gcloud alpha container fleet packages update diff --git a/gcloud/beta/container/hub/config-management/disable b/gcloud/beta/container/hub/config-management/disable index 9cd7ec233..ec43ed85c 100644 --- a/gcloud/beta/container/hub/config-management/disable +++ b/gcloud/beta/container/hub/config-management/disable @@ -1,40 +1,101 @@ NAME - gcloud beta container hub config-management disable - disable Config + gcloud beta container hub config-management disable - disable the Config Management feature SYNOPSIS - gcloud beta container hub config-management disable - [--fleet-default-member-config | --force] [GCLOUD_WIDE_FLAG ...] + gcloud beta container hub config-management disable [--force] + [--fleet-default-member-config | --uninstall --all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Disable the Config Management feature in a fleet. Disable the - feature entirely or only disable fleet-default membership configuration - (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features) - for the feature. + (BETA) Disable the Config Management feature entirely, or disable specific + configuration on the feature. + + gcloud beta container hub config-management disable without flags deletes + the Config Management feature, which unmanages and leaves existing Config + Sync installations on membership clusters. Running the command without + flags exits silently if the feature does not exist. Specify flags to + disable configuration on parts of the feature without deleting it. EXAMPLES To disable the Config Management feature entirely, run: $ gcloud beta container hub config-management disable - To disable only fleet-default membership configuration for the feature, - run: + To unmanage Config Sync only on select memberships, run: $ gcloud beta container hub config-management disable \ - --fleet-default-member-config + --memberships=example-membership-1,example-membership-2 FLAGS + --force + Force disablement. Bypasses any prompts for confirmation. When + disabling the entire feature, proceeds even if the feature is in use. + Might result in unexpected behavior. + At most one of these can be specified: --fleet-default-member-config Disable the fleet-default membership configuration (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features). - Does not change existing membership configurations. + Does not change existing membership configurations. Does nothing if + the feature is disabled. - --force - Force disablement. Bypasses any prompts for confirmation. When - disabling the entire feature, proceeds even if the feature is in use. - Might result in unexpected behavior. + Membership-specific flags. In the absence of --uninstall, using either + --memberships or --all-memberships removes the entire configuration for + the specified memberships, which unmanages and leaves existing Config + Sync installations on the membership clusters. Unmanagement does not + error if the feature is disabled. + + --uninstall + Uninstall any previously-installed and managed Config Sync on the + specified memberships by setting the enabled field + (https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/reference/gcloud-apply-fields) + to false. Clears all other configuration for each membership. Does + not wait for the uninstallation to complete. To bypass the + confirmation prompt, use --force. Requires the feature to be + enabled. + + To uninstall Config Sync on select memberships, run: + + $ gcloud beta container hub config-management disable --uninstall \ + --memberships=example-membership-1,example-membership-2 + + At most one of these can be specified: + + --all-memberships + All 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, diff --git a/gcloud/beta/container/hub/config-management/help b/gcloud/beta/container/hub/config-management/help index da53a607a..33e30c9b3 100644 --- a/gcloud/beta/container/hub/config-management/help +++ b/gcloud/beta/container/hub/config-management/help @@ -23,7 +23,7 @@ COMMANDS (BETA) Update a Config Management feature spec. disable - (BETA) Disable Config Management feature. + (BETA) Disable the Config Management feature. enable (BETA) Enable Config Management feature. diff --git a/gcloud/beta/container/hub/packages/create b/gcloud/beta/container/hub/packages/create index 44574c0e5..b642d4f7a 100644 --- a/gcloud/beta/container/hub/packages/create +++ b/gcloud/beta/container/hub/packages/create @@ -36,8 +36,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container hub packages create $ gcloud alpha container hub packages create diff --git a/gcloud/beta/container/hub/packages/delete b/gcloud/beta/container/hub/packages/delete index df4c6fb24..ee9fc9111 100644 --- a/gcloud/beta/container/hub/packages/delete +++ b/gcloud/beta/container/hub/packages/delete @@ -61,8 +61,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container hub packages delete $ gcloud alpha container hub packages delete diff --git a/gcloud/beta/container/hub/packages/describe b/gcloud/beta/container/hub/packages/describe index e0e16718b..3757abc05 100644 --- a/gcloud/beta/container/hub/packages/describe +++ b/gcloud/beta/container/hub/packages/describe @@ -61,8 +61,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container hub packages describe $ gcloud alpha container hub packages describe diff --git a/gcloud/beta/container/hub/packages/help b/gcloud/beta/container/hub/packages/help index 7aed3f994..b18d864b4 100644 --- a/gcloud/beta/container/hub/packages/help +++ b/gcloud/beta/container/hub/packages/help @@ -40,8 +40,10 @@ COMMANDS (BETA) Update Package Rollouts Fleet Package. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container hub packages $ gcloud alpha container hub packages diff --git a/gcloud/beta/container/hub/packages/list b/gcloud/beta/container/hub/packages/list index 79a83f766..b5f82add0 100644 --- a/gcloud/beta/container/hub/packages/list +++ b/gcloud/beta/container/hub/packages/list @@ -60,8 +60,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container hub packages list $ gcloud alpha container hub packages list diff --git a/gcloud/beta/container/hub/packages/resource-bundles/create b/gcloud/beta/container/hub/packages/resource-bundles/create index c1f8f548e..37df0743a 100644 --- a/gcloud/beta/container/hub/packages/resource-bundles/create +++ b/gcloud/beta/container/hub/packages/resource-bundles/create @@ -36,8 +36,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container hub packages resource-bundles create $ gcloud alpha container hub packages resource-bundles create diff --git a/gcloud/beta/container/hub/packages/resource-bundles/delete b/gcloud/beta/container/hub/packages/resource-bundles/delete index 101fa7579..8cd306302 100644 --- a/gcloud/beta/container/hub/packages/resource-bundles/delete +++ b/gcloud/beta/container/hub/packages/resource-bundles/delete @@ -36,8 +36,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container hub packages resource-bundles delete $ gcloud alpha container hub packages resource-bundles delete diff --git a/gcloud/beta/container/hub/packages/resource-bundles/describe b/gcloud/beta/container/hub/packages/resource-bundles/describe index 9bab268c7..3fbdd2ec4 100644 --- a/gcloud/beta/container/hub/packages/resource-bundles/describe +++ b/gcloud/beta/container/hub/packages/resource-bundles/describe @@ -32,8 +32,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container hub packages resource-bundles describe $ gcloud alpha container hub packages resource-bundles describe diff --git a/gcloud/beta/container/hub/packages/resource-bundles/help b/gcloud/beta/container/hub/packages/resource-bundles/help index 060d18d62..50236b549 100644 --- a/gcloud/beta/container/hub/packages/resource-bundles/help +++ b/gcloud/beta/container/hub/packages/resource-bundles/help @@ -40,8 +40,10 @@ COMMANDS (BETA) Update Package Rollouts Resource Bundle. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container hub packages resource-bundles $ gcloud alpha container hub packages resource-bundles diff --git a/gcloud/beta/container/hub/packages/resource-bundles/list b/gcloud/beta/container/hub/packages/resource-bundles/list index a4e76df99..9d17c2a2c 100644 --- a/gcloud/beta/container/hub/packages/resource-bundles/list +++ b/gcloud/beta/container/hub/packages/resource-bundles/list @@ -62,8 +62,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container hub packages resource-bundles list $ gcloud alpha container hub packages resource-bundles list diff --git a/gcloud/beta/container/hub/packages/resource-bundles/releases/create b/gcloud/beta/container/hub/packages/resource-bundles/releases/create index 14b083f8e..a10cfd694 100644 --- a/gcloud/beta/container/hub/packages/resource-bundles/releases/create +++ b/gcloud/beta/container/hub/packages/resource-bundles/releases/create @@ -66,8 +66,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container hub packages resource-bundles releases create $ gcloud alpha container hub packages resource-bundles releases \ create diff --git a/gcloud/beta/container/hub/packages/resource-bundles/releases/delete b/gcloud/beta/container/hub/packages/resource-bundles/releases/delete index 1522210de..7f7663f65 100644 --- a/gcloud/beta/container/hub/packages/resource-bundles/releases/delete +++ b/gcloud/beta/container/hub/packages/resource-bundles/releases/delete @@ -42,8 +42,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container hub packages resource-bundles releases delete $ gcloud alpha container hub packages resource-bundles releases \ delete diff --git a/gcloud/beta/container/hub/packages/resource-bundles/releases/describe b/gcloud/beta/container/hub/packages/resource-bundles/releases/describe index 30746f97d..cb5cc69fc 100644 --- a/gcloud/beta/container/hub/packages/resource-bundles/releases/describe +++ b/gcloud/beta/container/hub/packages/resource-bundles/releases/describe @@ -38,8 +38,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container hub packages resource-bundles releases describe $ gcloud alpha container hub packages resource-bundles releases \ describe diff --git a/gcloud/beta/container/hub/packages/resource-bundles/releases/help b/gcloud/beta/container/hub/packages/resource-bundles/releases/help index b570aa6ea..2d1501f14 100644 --- a/gcloud/beta/container/hub/packages/resource-bundles/releases/help +++ b/gcloud/beta/container/hub/packages/resource-bundles/releases/help @@ -34,8 +34,10 @@ COMMANDS (BETA) Update Package Rollouts Release. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container hub packages resource-bundles releases $ gcloud alpha container hub packages resource-bundles releases diff --git a/gcloud/beta/container/hub/packages/resource-bundles/releases/list b/gcloud/beta/container/hub/packages/resource-bundles/releases/list index 80164d494..c0ec49990 100644 --- a/gcloud/beta/container/hub/packages/resource-bundles/releases/list +++ b/gcloud/beta/container/hub/packages/resource-bundles/releases/list @@ -66,8 +66,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container hub packages resource-bundles releases list $ gcloud alpha container hub packages resource-bundles releases list diff --git a/gcloud/beta/container/hub/packages/resource-bundles/releases/update b/gcloud/beta/container/hub/packages/resource-bundles/releases/update index a617642af..f72679d9f 100644 --- a/gcloud/beta/container/hub/packages/resource-bundles/releases/update +++ b/gcloud/beta/container/hub/packages/resource-bundles/releases/update @@ -41,8 +41,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container hub packages resource-bundles releases update $ gcloud alpha container hub packages resource-bundles releases \ update diff --git a/gcloud/beta/container/hub/packages/resource-bundles/update b/gcloud/beta/container/hub/packages/resource-bundles/update index e9aed9c43..803615b7b 100644 --- a/gcloud/beta/container/hub/packages/resource-bundles/update +++ b/gcloud/beta/container/hub/packages/resource-bundles/update @@ -36,8 +36,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container hub packages resource-bundles update $ gcloud alpha container hub packages resource-bundles update diff --git a/gcloud/beta/container/hub/packages/rollouts/abort b/gcloud/beta/container/hub/packages/rollouts/abort index 39cd9926e..7926d34a8 100644 --- a/gcloud/beta/container/hub/packages/rollouts/abort +++ b/gcloud/beta/container/hub/packages/rollouts/abort @@ -66,8 +66,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container hub packages rollouts abort $ gcloud alpha container hub packages rollouts abort diff --git a/gcloud/beta/container/hub/packages/rollouts/describe b/gcloud/beta/container/hub/packages/rollouts/describe index b8726af2c..524959ce2 100644 --- a/gcloud/beta/container/hub/packages/rollouts/describe +++ b/gcloud/beta/container/hub/packages/rollouts/describe @@ -40,8 +40,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container hub packages rollouts describe $ gcloud alpha container hub packages rollouts describe diff --git a/gcloud/beta/container/hub/packages/rollouts/help b/gcloud/beta/container/hub/packages/rollouts/help index 276d51f63..45a4b3cc2 100644 --- a/gcloud/beta/container/hub/packages/rollouts/help +++ b/gcloud/beta/container/hub/packages/rollouts/help @@ -32,8 +32,10 @@ COMMANDS (BETA) Suspend in-progress Rollout. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container hub packages rollouts $ gcloud alpha container hub packages rollouts diff --git a/gcloud/beta/container/hub/packages/rollouts/list b/gcloud/beta/container/hub/packages/rollouts/list index 79d6d5f64..d193ea06d 100644 --- a/gcloud/beta/container/hub/packages/rollouts/list +++ b/gcloud/beta/container/hub/packages/rollouts/list @@ -70,8 +70,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container hub packages rollouts list $ gcloud alpha container hub packages rollouts list diff --git a/gcloud/beta/container/hub/packages/rollouts/resume b/gcloud/beta/container/hub/packages/rollouts/resume index 82e0358dc..56bd18dc2 100644 --- a/gcloud/beta/container/hub/packages/rollouts/resume +++ b/gcloud/beta/container/hub/packages/rollouts/resume @@ -67,8 +67,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container hub packages rollouts resume $ gcloud alpha container hub packages rollouts resume diff --git a/gcloud/beta/container/hub/packages/rollouts/suspend b/gcloud/beta/container/hub/packages/rollouts/suspend index 06027a8ab..947242b9e 100644 --- a/gcloud/beta/container/hub/packages/rollouts/suspend +++ b/gcloud/beta/container/hub/packages/rollouts/suspend @@ -67,8 +67,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container hub packages rollouts suspend $ gcloud alpha container hub packages rollouts suspend diff --git a/gcloud/beta/container/hub/packages/update b/gcloud/beta/container/hub/packages/update index d1b93ce2a..ef0a10db1 100644 --- a/gcloud/beta/container/hub/packages/update +++ b/gcloud/beta/container/hub/packages/update @@ -61,8 +61,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container hub packages update $ gcloud alpha container hub packages update diff --git a/gcloud/beta/dataflow/flex-template/build b/gcloud/beta/dataflow/flex-template/build index 41238460d..8b03860c6 100644 --- a/gcloud/beta/dataflow/flex-template/build +++ b/gcloud/beta/dataflow/flex-template/build @@ -91,9 +91,11 @@ REQUIRED FLAGS --flex-template-base-image=FLEX_TEMPLATE_BASE_IMAGE Flex template base image to be used while building the container image. Allowed choices are allowed labels (JAVA11, JAVA17, JAVA21, - PYTHON3, GO), or full gcr.io path of the specific version of the base - image. For labels, we use the latest base image version to build the - container. You can also provide a specific version from this link + PYTHON3, GO), supported distroless images (JAVA11_DISTROLESS, + JAVA17_DISTROLESS, JAVA21_DISTROLESS, GO_DISTROLESS), or full gcr.io + path of the specific version of the base image. For labels, we use + the latest base image version to build the container. You can also + provide a specific version from this link https://gcr.io/dataflow-templates-base/ This flag argument must be specified if any of the other arguments in diff --git a/gcloud/beta/managed-kafka/acls/list b/gcloud/beta/managed-kafka/acls/list index 407456500..618b112af 100644 --- a/gcloud/beta/managed-kafka/acls/list +++ b/gcloud/beta/managed-kafka/acls/list @@ -4,8 +4,8 @@ NAME SYNOPSIS gcloud beta managed-kafka acls list (CLUSTER : --location=LOCATION) - [--filter=EXPRESSION] [--limit=LIMIT] [--sort-by=[FIELD,...]] - [GCLOUD_WIDE_FLAG ...] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) List all Managed Service for Apache Kafka acls in a given cluster. @@ -65,6 +65,13 @@ LIST COMMAND FLAGS 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 diff --git a/gcloud/beta/managed-kafka/clusters/update b/gcloud/beta/managed-kafka/clusters/update index 80b4a876f..e646f47c0 100644 --- a/gcloud/beta/managed-kafka/clusters/update +++ b/gcloud/beta/managed-kafka/clusters/update @@ -7,7 +7,8 @@ SYNOPSIS (--auto-rebalance --cpu=CPU --labels=[KEY=VALUE,...] --memory=MEMORY --ssl-principal-mapping-rules=SSL_PRINCIPAL_MAPPING_RULES --subnets=[SUBNETS,...] --clear-mtls-ca-pools - | --mtls-ca-pools=[MTLS_CA_POOLS,...]) [--async] + | --mtls-ca-pools=[MTLS_CA_POOLS,...]) + [--allow-broker-downscale-on-cluster-upscale] [--async] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -117,6 +118,13 @@ REQUIRED FLAGS CA pools using the --clear-mtls-ca-pools flag. OPTIONAL FLAGS + --allow-broker-downscale-on-cluster-upscale + If enabled, this setting allows an update operation that could + significantly decrease the per-broker vCPU and/or memory allocation, + which can lead to reduced performance and availability. By default, an + update operation will fail if it results in a reduction of 10% or more + to the brokers' vCPU or memory allocation. + --async Return immediately, without waiting for the operation in progress to complete. diff --git a/gcloud/beta/ml-engine/explain b/gcloud/beta/ml-engine/explain deleted file mode 100644 index 4d349843e..000000000 --- a/gcloud/beta/ml-engine/explain +++ /dev/null @@ -1,102 +0,0 @@ -NAME - gcloud beta ml-engine explain - run AI Platform explanation - -SYNOPSIS - gcloud beta ml-engine explain --model=MODEL - (--json-instances=JSON_INSTANCES | --json-request=JSON_REQUEST - | --text-instances=TEXT_INSTANCES) [--region=REGION] - [--version=VERSION] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) gcloud beta ml-engine explain sends an explain request to AI - Platform for the given instances. This command will read up to 100 - instances, though the service itself will accept instances up to the - payload limit size (currently, 1.5MB). - -EXAMPLES - To get explanations for an AI Platform version model with the version - 'version' and with the name 'model-name', run: - - $ gcloud beta ml-engine explain explain --model=model-name \ - --version=version --json-instances=instances.json - -REQUIRED FLAGS - --model=MODEL - Name of the model. - - Exactly one of these must be specified: - - --json-instances=JSON_INSTANCES - Path to a local file from which instances are read. Instances are in - JSON format; newline delimited. - - An example of the JSON instances file: - - {"images": [0.0, ..., 0.1], "key": 3} - {"images": [0.0, ..., 0.1], "key": 2} - ... - - This flag accepts "-" for stdin. - - --json-request=JSON_REQUEST - Path to a local file containing the body of JSON request. - - An example of a JSON request: - - { - "instances": [ - {"x": [1, 2], "y": [3, 4]}, - {"x": [-1, -2], "y": [-3, -4]} - ] - } - - This flag accepts "-" for stdin. - - --text-instances=TEXT_INSTANCES - Path to a local file from which instances are read. Instances are in - UTF-8 encoded text format; newline delimited. - - An example of the text instances file: - - 107,4.9,2.5,4.5,1.7 - 100,5.7,2.8,4.1,1.3 - ... - - This flag accepts "-" for stdin. - -OPTIONAL FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - - --version=VERSION - Model version to be used. - - If unspecified, the default version of the model will be used. To list - model versions run - - $ gcloud beta ml-engine versions list - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -NOTES - This command is currently in beta and might change without notice. This - variant is also available: - - $ gcloud alpha ml-engine explain - diff --git a/gcloud/beta/ml-engine/help b/gcloud/beta/ml-engine/help deleted file mode 100644 index f546c7348..000000000 --- a/gcloud/beta/ml-engine/help +++ /dev/null @@ -1,59 +0,0 @@ -NAME - gcloud beta ml-engine - manage AI Platform jobs and models - -SYNOPSIS - gcloud beta ml-engine GROUP | COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) The gcloud beta ml-engine command group lets you manage AI Platform - jobs and training models. - - AI Platform is a managed service that enables you to easily build machine - learning models, that work on any type of data, of any size. Create your - model with the powerful TensorFlow framework that powers many Google - products, from Google Photos to Google Cloud Speech. - - More information on AI Platform can be found here: - https://cloud.google.com/ml and detailed documentation can be found here: - https://cloud.google.com/ml/docs/ - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -GROUPS - GROUP is one of the following: - - jobs - (BETA) AI Platform Jobs commands. - - local - (BETA) AI Platform Local commands. - - models - (BETA) AI Platform Models commands. - - operations - (BETA) Manage AI Platform operations. - - versions - (BETA) AI Platform Versions commands. - -COMMANDS - COMMAND is one of the following: - - explain - (BETA) Run AI Platform explanation. - - predict - (BETA) Run AI Platform online prediction. - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud ml-engine - - $ gcloud alpha ml-engine - diff --git a/gcloud/beta/ml-engine/jobs/cancel b/gcloud/beta/ml-engine/jobs/cancel deleted file mode 100644 index d4d7b0fd9..000000000 --- a/gcloud/beta/ml-engine/jobs/cancel +++ /dev/null @@ -1,31 +0,0 @@ -NAME - gcloud beta ml-engine jobs cancel - cancel a running AI Platform job - -SYNOPSIS - gcloud beta ml-engine jobs cancel JOB [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) gcloud beta ml-engine jobs cancel cancels a running AI Platform job. - If the job is already finished, the command will not perform an operation - and exit successfully. - -POSITIONAL ARGUMENTS - JOB - Name of the job. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine jobs cancel - - $ gcloud alpha ml-engine jobs cancel - diff --git a/gcloud/beta/ml-engine/jobs/describe b/gcloud/beta/ml-engine/jobs/describe deleted file mode 100644 index 9857db8cc..000000000 --- a/gcloud/beta/ml-engine/jobs/describe +++ /dev/null @@ -1,57 +0,0 @@ -NAME - gcloud beta ml-engine jobs describe - describe an AI Platform job - -SYNOPSIS - gcloud beta ml-engine jobs describe JOB [--summarize] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Describe an AI Platform job. - -EXAMPLES - To describe the AI Platform job named my-job, run: - - gcloud beta ml-engine jobs describe my-job - -POSITIONAL ARGUMENTS - JOB - Name of the job. - -FLAGS - --summarize - Summarize job output in a set of human readable tables instead of - rendering the entire resource as json or yaml. The tables currently - rendered are: - - ◆ Job Overview: Overview of job including, jobId, status and create - time. - ◆ Training Input Summary: Summary of input for a training job - including region, main training python module and scale tier. - ◆ Training Output Summary: Summary of output for a training job - including the amount of ML units consumed by the job. - ◆ Training Output Trials: Summary of hyperparameter trials run for a - hyperparameter tuning training job. - ◆ Predict Input Summary: Summary of input for a prediction job - including region, model verion and output path. - ◆ Predict Output Summary: Summary of output for a prediction job - including prediction count and output path. - - This flag overrides the --format flag. If both are present on the - command line, a warning is displayed. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine jobs describe - - $ gcloud alpha ml-engine jobs describe - diff --git a/gcloud/beta/ml-engine/jobs/help b/gcloud/beta/ml-engine/jobs/help deleted file mode 100644 index 32dfaf87f..000000000 --- a/gcloud/beta/ml-engine/jobs/help +++ /dev/null @@ -1,46 +0,0 @@ -NAME - gcloud beta ml-engine jobs - AI Platform Jobs commands - -SYNOPSIS - gcloud beta ml-engine jobs GROUP | COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) AI Platform Jobs commands. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -GROUPS - GROUP is one of the following: - - submit - (BETA) AI Platform Jobs submit commands. - -COMMANDS - COMMAND is one of the following: - - cancel - (BETA) Cancel a running AI Platform job. - - describe - (BETA) Describe an AI Platform job. - - list - (BETA) List existing AI Platform jobs. - - stream-logs - (BETA) Show logs from a running AI Platform job. - - update - (BETA) Update an AI Platform job. - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud ml-engine jobs - - $ gcloud alpha ml-engine jobs - diff --git a/gcloud/beta/ml-engine/jobs/stream-logs b/gcloud/beta/ml-engine/jobs/stream-logs deleted file mode 100644 index f27545854..000000000 --- a/gcloud/beta/ml-engine/jobs/stream-logs +++ /dev/null @@ -1,49 +0,0 @@ -NAME - gcloud beta ml-engine jobs stream-logs - show logs from a running AI - Platform job - -SYNOPSIS - gcloud beta ml-engine jobs stream-logs JOB [--allow-multiline-logs] - [--polling-interval=POLLING_INTERVAL; default=60] - [--task-name=TASK_NAME] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Show logs from a running AI Platform job. - -EXAMPLES - To show the logs from running the AI Platform job my-job, run: - - $ gcloud beta ml-engine jobs stream-logs my-job - -POSITIONAL ARGUMENTS - JOB - Name of the job. - -FLAGS - --allow-multiline-logs - Output multiline log messages as single records. - - --polling-interval=POLLING_INTERVAL; default=60 - Number of seconds to wait between efforts to fetch the latest log - messages. Overrides the default ml_engine/polling_interval property - value for this command invocation. - - --task-name=TASK_NAME - If set, display only the logs for this particular task. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine jobs stream-logs - - $ gcloud alpha ml-engine jobs stream-logs - diff --git a/gcloud/beta/ml-engine/jobs/submit/help b/gcloud/beta/ml-engine/jobs/submit/help deleted file mode 100644 index 1338ade4f..000000000 --- a/gcloud/beta/ml-engine/jobs/submit/help +++ /dev/null @@ -1,31 +0,0 @@ -NAME - gcloud beta ml-engine jobs submit - AI Platform Jobs submit commands - -SYNOPSIS - gcloud beta ml-engine jobs submit COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) AI Platform Jobs submit commands. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -COMMANDS - COMMAND is one of the following: - - prediction - (BETA) Start an AI Platform batch prediction job. - - training - (BETA) Submit an AI Platform training job. - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud ml-engine jobs submit - - $ gcloud alpha ml-engine jobs submit - diff --git a/gcloud/beta/ml-engine/jobs/submit/prediction b/gcloud/beta/ml-engine/jobs/submit/prediction deleted file mode 100644 index 4940cf870..000000000 --- a/gcloud/beta/ml-engine/jobs/submit/prediction +++ /dev/null @@ -1,121 +0,0 @@ -NAME - gcloud beta ml-engine jobs submit prediction - start an AI Platform batch - prediction job - -SYNOPSIS - gcloud beta ml-engine jobs submit prediction JOB --data-format=DATA_FORMAT - --input-paths=INPUT_PATH,[INPUT_PATH,...] --output-path=OUTPUT_PATH - --region=REGION (--model=MODEL | --model-dir=MODEL_DIR) - [--batch-size=BATCH_SIZE] [--labels=[KEY=VALUE,...]] - [--max-worker-count=MAX_WORKER_COUNT] - [--runtime-version=RUNTIME_VERSION] [--signature-name=SIGNATURE_NAME] - [--version=VERSION] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Start an AI Platform batch prediction job. - -POSITIONAL ARGUMENTS - JOB - Name of the batch prediction job. - -REQUIRED FLAGS - --data-format=DATA_FORMAT - Data format of the input files. DATA_FORMAT must be one of: - - text - Text and JSON files; for text files, see - https://www.tensorflow.org/guide/datasets#consuming_text_data, for - JSON files, see - https://cloud.google.com/ai-platform/prediction/docs/overview#batch_prediction_input_data - tf-record - TFRecord files; see - https://www.tensorflow.org/guide/datasets#consuming_tfrecord_data - tf-record-gzip - GZIP-compressed TFRecord files. - - --input-paths=INPUT_PATH,[INPUT_PATH,...] - Cloud Storage paths to the instances to run prediction on. - - Wildcards (*) accepted at the end of a path. More than one path can be - specified if multiple file patterns are needed. For example, - - gs://my-bucket/instances*,gs://my-bucket/other-instances1 - - will match any objects whose names start with instances in my-bucket as - well as the other-instances1 bucket, while - - gs://my-bucket/instance-dir/* - - will match any objects in the instance-dir "directory" (since - directories aren't a first-class Cloud Storage concept) of my-bucket. - - --output-path=OUTPUT_PATH - Cloud Storage path to which to save the output. Example: - gs://my-bucket/output. - - --region=REGION - The Compute Engine region to run the job in. - - Exactly one of these must be specified: - - --model=MODEL - Name of the model to use for prediction. - - --model-dir=MODEL_DIR - Cloud Storage location where the model files are located. - -OPTIONAL FLAGS - --batch-size=BATCH_SIZE - The number of records per batch. The service will buffer batch_size - number of records in memory before invoking TensorFlow. Defaults to 64 - if not specified. - - --labels=[KEY=VALUE,...] - List of label KEY=VALUE pairs to add. - - Keys must start with a lowercase character and contain only hyphens - (-), underscores (_), lowercase characters, and numbers. Values must - contain only hyphens (-), underscores (_), lowercase characters, and - numbers. - - --max-worker-count=MAX_WORKER_COUNT - The maximum number of workers to be used for parallel processing. - Defaults to 10 if not specified. - - --runtime-version=RUNTIME_VERSION - AI Platform runtime version for this job. Must be specified unless - --master-image-uri is specified instead. It is defined in documentation - along with the list of supported versions: - https://cloud.google.com/ai-platform/prediction/docs/runtime-version-list - - --signature-name=SIGNATURE_NAME - Name of the signature defined in the SavedModel to use for this job. - Defaults to DEFAULT_SERVING_SIGNATURE_DEF_KEY in - https://www.tensorflow.org/api_docs/python/tf/compat/v1/saved_model/signature_constants, - which is "serving_default". Only applies to TensorFlow models. - - --version=VERSION - Model version to be used. - - This flag may only be given if --model is specified. If unspecified, - the default version of the model will be used. To list versions for a - model, run - - $ gcloud ai-platform versions list - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud ml-engine jobs submit prediction - - $ gcloud alpha ml-engine jobs submit prediction - diff --git a/gcloud/beta/ml-engine/jobs/submit/training b/gcloud/beta/ml-engine/jobs/submit/training deleted file mode 100644 index 71ea0f5ae..000000000 --- a/gcloud/beta/ml-engine/jobs/submit/training +++ /dev/null @@ -1,437 +0,0 @@ -NAME - gcloud beta ml-engine jobs submit training - submit an AI Platform training - job - -SYNOPSIS - gcloud beta ml-engine jobs submit training JOB [--config=CONFIG] - [--enable-web-access] [--job-dir=JOB_DIR] [--labels=[KEY=VALUE,...]] - [--master-accelerator=[count=COUNT],[type=TYPE]] - [--master-image-uri=MASTER_IMAGE_URI] - [--master-machine-type=MASTER_MACHINE_TYPE] [--module-name=MODULE_NAME] - [--network=NETWORK] [--package-path=PACKAGE_PATH] - [--packages=[PACKAGE,...]] - [--parameter-server-accelerator=[count=COUNT],[type=TYPE]] - [--parameter-server-image-uri=PARAMETER_SERVER_IMAGE_URI] - [--python-version=PYTHON_VERSION] [--region=REGION] - [--runtime-version=RUNTIME_VERSION] [--scale-tier=SCALE_TIER] - [--service-account=SERVICE_ACCOUNT] [--staging-bucket=STAGING_BUCKET] - [--tpu-tf-version=TPU_TF_VERSION] - [--use-chief-in-tf-config=USE_CHIEF_IN_TF_CONFIG] - [--worker-accelerator=[count=COUNT],[type=TYPE]] - [--worker-image-uri=WORKER_IMAGE_URI] [--async | --stream-logs] - [--kms-key=KMS_KEY : --kms-keyring=KMS_KEYRING - --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT] - [--parameter-server-count=PARAMETER_SERVER_COUNT - --parameter-server-machine-type=PARAMETER_SERVER_MACHINE_TYPE] - [--worker-count=WORKER_COUNT --worker-machine-type=WORKER_MACHINE_TYPE] - [GCLOUD_WIDE_FLAG ...] [-- USER_ARGS ...] - -DESCRIPTION - (BETA) Submit an AI Platform training job. - - This creates temporary files and executes Python code staged by a user on - Cloud Storage. Model code can either be specified with a path, e.g.: - - $ gcloud beta ml-engine jobs submit training my_job \ - --module-name trainer.task \ - --staging-bucket gs://my-bucket \ - --package-path /my/code/path/trainer \ - --packages additional-dep1.tar.gz,dep2.whl - - Or by specifying an already built package: - - $ gcloud beta ml-engine jobs submit training my_job \ - --module-name trainer.task \ - --staging-bucket gs://my-bucket \ - --packages trainer-0.0.1.tar.gz,additional-dep1.tar.gz,dep2.whl - - If --package-path=/my/code/path/trainer is specified and there is a - setup.py file at /my/code/path/setup.py, the setup file will be invoked - with sdist and the generated tar files will be uploaded to Cloud Storage. - Otherwise, a temporary setup.py file will be generated for the build. - - By default, this command runs asynchronously; it exits once the job is - successfully submitted. - - To follow the progress of your job, pass the --stream-logs flag (note that - even with the --stream-logs flag, the job will continue to run after this - command exits and must be cancelled with gcloud ai-platform jobs cancel - JOB_ID). - - For more information, see: - https://cloud.google.com/ai-platform/training/docs/overview - -POSITIONAL ARGUMENTS - JOB - Name of the job. - - [-- USER_ARGS ...] - Additional user arguments to be forwarded to user code - - The '--' argument must be specified between gcloud specific args on the - left and USER_ARGS on the right. - -FLAGS - --config=CONFIG - Path to the job configuration file. This file should be a YAML document - (JSON also accepted) containing a Job resource as defined in the API - (all fields are optional): - https://cloud.google.com/ml/reference/rest/v1/projects.jobs - - EXAMPLES: - - JSON: - - { - "jobId": "my_job", - "labels": { - "type": "prod", - "owner": "alice" - }, - "trainingInput": { - "scaleTier": "BASIC", - "packageUris": [ - "gs://my/package/path" - ], - "region": "us-east1" - } - } - - YAML: - - jobId: my_job - labels: - type: prod - owner: alice - trainingInput: - scaleTier: BASIC - packageUris: - - gs://my/package/path - region: us-east1 - - If an option is specified both in the configuration file **and** via - command line arguments, the command line arguments override the - configuration file. - - --enable-web-access - Whether you want AI Platform Training to enable [interactive shell - access] - (https://cloud.google.com/ai-platform/training/docs/monitor-debug-interactive-shell) - to training containers. If set to true, you can access interactive - shells at the URIs given by TrainingOutput.web_access_uris or - HyperparameterOutput.web_access_uris (within TrainingOutput.trials). - - --job-dir=JOB_DIR - Cloud Storage path in which to store training outputs and other data - needed for training. - - This path will be passed to your TensorFlow program as the --job-dir - command-line arg. The benefit of specifying this field is that AI - Platform will validate the path for use in training. However, note that - your training program will need to parse the provided --job-dir - argument. - - If packages must be uploaded and --staging-bucket is not provided, this - path will be used instead. - - --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. - - --master-accelerator=[count=COUNT],[type=TYPE] - Hardware accelerator config for the master worker. Must specify both - the accelerator type (TYPE) for each server and the number of - accelerators to attach to each server (COUNT). - - type - Type of the accelerator. Choices are - nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4-pod - - count - Number of accelerators to attach to each machine running the job. - Must be greater than 0. - - --master-image-uri=MASTER_IMAGE_URI - Docker image to run on each master worker. This image must be in - Container Registry. Only one of --master-image-uri and - --runtime-version must be specified. - - --master-machine-type=MASTER_MACHINE_TYPE - Specifies the type of virtual machine to use for training job's master - worker. - - You must set this value when --scale-tier is set to CUSTOM. - - --module-name=MODULE_NAME - Name of the module to run. - - --network=NETWORK - Full name of the Google Compute Engine network - (https://cloud.google.com/vpc/docs) to which the Job is peered with. - For example, projects/12345/global/networks/myVPC. The format is of the - form projects/{project}/global/networks/{network}, where {project} is a - project number, as in '12345', and {network} is network name. Private - services access must already have been configured - (https://cloud.google.com/vpc/docs/configure-private-services-access) - for the network. If unspecified, the Job is not peered with any - network. - - --package-path=PACKAGE_PATH - Path to a Python package to build. This should point to a local - directory containing the Python source for the job. It will be built - using setuptools (which must be installed) using its parent directory - as context. If the parent directory contains a setup.py file, the build - will use that; otherwise, it will use a simple built-in one. - - --packages=[PACKAGE,...] - Path to Python archives used for training. These can be local paths - (absolute or relative), in which case they will be uploaded to the - Cloud Storage bucket given by --staging-bucket, or Cloud Storage URLs - ('gs://bucket-name/path/to/package.tar.gz'). - - --parameter-server-accelerator=[count=COUNT],[type=TYPE] - Hardware accelerator config for the parameter servers. Must specify - both the accelerator type (TYPE) for each server and the number of - accelerators to attach to each server (COUNT). - - type - Type of the accelerator. Choices are - nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4-pod - - count - Number of accelerators to attach to each machine running the job. - Must be greater than 0. - - --parameter-server-image-uri=PARAMETER_SERVER_IMAGE_URI - Docker image to run on each parameter server. This image must be in - Container Registry. If not specified, the value of --master-image-uri - is used. - - --python-version=PYTHON_VERSION - Version of Python used during training. Choices are 3.7, 3.5, and 2.7. - However, this value must be compatible with the chosen runtime version - for the job. - - Must be used with a compatible runtime version: - - ◆ 3.7 is compatible with runtime versions 1.15 and later. - ◆ 3.5 is compatible with runtime versions 1.4 through 1.14. - ◆ 2.7 is compatible with runtime versions 1.15 and earlier. - - --region=REGION - Region of the machine learning training job to submit. If not - specified, you might be prompted to select a region (interactive mode - only). - - To avoid prompting when this flag is omitted, you can set the - compute/region property: - - $ gcloud config set compute/region REGION - - A list of regions can be fetched by running: - - $ gcloud compute regions list - - To unset the property, run: - - $ gcloud config unset compute/region - - Alternatively, the region can be stored in the environment variable - CLOUDSDK_COMPUTE_REGION. - - --runtime-version=RUNTIME_VERSION - AI Platform runtime version for this job. Must be specified unless - --master-image-uri is specified instead. It is defined in documentation - along with the list of supported versions: - https://cloud.google.com/ai-platform/prediction/docs/runtime-version-list - - --scale-tier=SCALE_TIER - Specify the machine types, the number of replicas for workers, and - parameter servers. SCALE_TIER must be one of: - - basic - Single worker instance. This tier is suitable for learning how to - use AI Platform, and for experimenting with new models using small - datasets. - basic-gpu - Single worker instance with a GPU. - basic-tpu - Single worker instance with a Cloud TPU. - custom - CUSTOM tier is not a set tier, but rather enables you to use your - own cluster specification. When you use this tier, set values to - configure your processing cluster according to these guidelines - (using the --config flag): - - ▸ You must set TrainingInput.masterType to specify the type of - machine to use for your master node. This is the only required - setting. - ▸ You may set TrainingInput.workerCount to specify the number of - workers to use. If you specify one or more workers, you must also - set TrainingInput.workerType to specify the type of machine to - use for your worker nodes. - ▸ You may set TrainingInput.parameterServerCount to specify the - number of parameter servers to use. If you specify one or more - parameter servers, you must also set - TrainingInput.parameterServerType to specify the type of machine - to use for your parameter servers. Note that all of your workers - must use the same machine type, which can be different from your - parameter server type and master type. Your parameter servers - must likewise use the same machine type, which can be different - from your worker type and master type. - premium-1 - Large number of workers with many parameter servers. - standard-1 - Many workers and a few parameter servers. - - --service-account=SERVICE_ACCOUNT - The email address of a service account to use when running the training - appplication. You must have the iam.serviceAccounts.actAs permission - for the specified service account. In addition, the AI Platform - Training Google-managed service account must have the - roles/iam.serviceAccountAdmin role for the specified service account. - Learn more about configuring a service account. - (https://cloud.google.com/ai-platform/training/docs/custom-service-account) - If not specified, the AI Platform Training Google-managed service - account is used by default. - - --staging-bucket=STAGING_BUCKET - Bucket in which to stage training archives. - - Required only if a file upload is necessary (that is, other flags - include local paths) and no other flags implicitly specify an upload - path. - - --tpu-tf-version=TPU_TF_VERSION - Runtime version of TensorFlow used by the container. This field must be - specified if a custom container on the TPU worker is being used. - - --use-chief-in-tf-config=USE_CHIEF_IN_TF_CONFIG - Use "chief" role in the cluster instead of "master". This is required - for TensorFlow 2.0 and newer versions. Unlike "master" node, "chief" - node does not run evaluation. - - --worker-accelerator=[count=COUNT],[type=TYPE] - Hardware accelerator config for the worker nodes. Must specify both the - accelerator type (TYPE) for each server and the number of accelerators - to attach to each server (COUNT). - - type - Type of the accelerator. Choices are - nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4-pod - - count - Number of accelerators to attach to each machine running the job. - Must be greater than 0. - - --worker-image-uri=WORKER_IMAGE_URI - Docker image to run on each worker node. This image must be in - Container Registry. If not specified, the value of --master-image-uri - is used. - - At most one of these can be specified: - - --async - (DEPRECATED) Display information about the operation in progress - without waiting for the operation to complete. Enabled by default and - can be omitted; use --stream-logs to run synchronously. - - --stream-logs - Block until job completion and stream the logs while the job runs. - - Note that even if command execution is halted, the job will still run - until cancelled with - - $ gcloud ai-platform jobs cancel JOB_ID - - Key resource - The Cloud KMS (Key Management Service) cryptokey that will - be used to protect the job. The 'AI Platform Service Agent' service - account must hold permission 'Cloud KMS CryptoKey Encrypter/Decrypter'. - The arguments in this group can be used to specify the attributes of this - resource. - - --kms-key=KMS_KEY - ID of the key or fully qualified identifier for the key. - - To set the kms-key attribute: - ▸ provide the argument --kms-key on the command line. - - This flag argument must be specified if any of the other arguments in - this group are specified. - - --kms-keyring=KMS_KEYRING - The KMS keyring of the key. - - To set the kms-keyring attribute: - ▸ provide the argument --kms-key on the command line with a fully - specified name; - ▸ provide the argument --kms-keyring on the command line. - - --kms-location=KMS_LOCATION - The Google Cloud location for the key. - - To set the kms-location attribute: - ▸ provide the argument --kms-key on the command line with a fully - specified name; - ▸ provide the argument --kms-location on the command line. - - --kms-project=KMS_PROJECT - The Google Cloud project for the key. - - To set the kms-project attribute: - ▸ provide the argument --kms-key on the command line with a fully - specified name; - ▸ provide the argument --kms-project on the command line; - ▸ set the property core/project. - - Configure parameter server machine type settings. - - --parameter-server-count=PARAMETER_SERVER_COUNT - Number of parameter servers to use for the training job. - - This flag argument must be specified if any of the other arguments in - this group are specified. - - --parameter-server-machine-type=PARAMETER_SERVER_MACHINE_TYPE - Type of virtual machine to use for training job's parameter servers. - This flag must be specified if any of the other arguments in this - group are specified machine to use for training job's parameter - servers. - - This flag argument must be specified if any of the other arguments in - this group are specified. - - Configure worker node machine type settings. - - --worker-count=WORKER_COUNT - Number of worker nodes to use for the training job. - - This flag argument must be specified if any of the other arguments in - this group are specified. - - --worker-machine-type=WORKER_MACHINE_TYPE - Type of virtual machine to use for training job's worker nodes. - - This flag argument must be specified if any of the other arguments in - this group are specified. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine jobs submit training - - $ gcloud alpha ml-engine jobs submit training - diff --git a/gcloud/beta/ml-engine/jobs/update b/gcloud/beta/ml-engine/jobs/update deleted file mode 100644 index 546bc016d..000000000 --- a/gcloud/beta/ml-engine/jobs/update +++ /dev/null @@ -1,65 +0,0 @@ -NAME - gcloud beta ml-engine jobs update - update an AI Platform job - -SYNOPSIS - gcloud beta ml-engine jobs update JOB [--update-labels=[KEY=VALUE,...]] - [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Update an AI Platform job. - -EXAMPLES - To remove all labels in the AI Platform job named my-job, run: - - $ gcloud beta ml-engine jobs update my-job --clear-labels - -POSITIONAL ARGUMENTS - JOB - Name of the job. - -FLAGS - --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 ml-engine jobs update --clear-labels - - To remove all existing labels and create two new labels, foo and baz: - - $ gcloud beta ml-engine jobs 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. These - variants are also available: - - $ gcloud ml-engine jobs update - - $ gcloud alpha ml-engine jobs update - diff --git a/gcloud/beta/ml-engine/local/help b/gcloud/beta/ml-engine/local/help deleted file mode 100644 index 8376b678d..000000000 --- a/gcloud/beta/ml-engine/local/help +++ /dev/null @@ -1,31 +0,0 @@ -NAME - gcloud beta ml-engine local - AI Platform Local commands - -SYNOPSIS - gcloud beta ml-engine local COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) AI Platform Local commands. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -COMMANDS - COMMAND is one of the following: - - predict - (BETA) Run prediction locally. - - train - (BETA) Run an AI Platform training job locally. - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud ml-engine local - - $ gcloud alpha ml-engine local - diff --git a/gcloud/beta/ml-engine/local/predict b/gcloud/beta/ml-engine/local/predict deleted file mode 100644 index 5458d4487..000000000 --- a/gcloud/beta/ml-engine/local/predict +++ /dev/null @@ -1,89 +0,0 @@ -NAME - gcloud beta ml-engine local predict - run prediction locally - -SYNOPSIS - gcloud beta ml-engine local predict --model-dir=MODEL_DIR - (--json-instances=JSON_INSTANCES | --json-request=JSON_REQUEST - | --text-instances=TEXT_INSTANCES) [--framework=FRAMEWORK] - [--signature-name=SIGNATURE_NAME] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) gcloud beta ml-engine local predict performs prediction locally with - the given instances. It requires the TensorFlow SDK - (https://www.tensorflow.org/install) be installed locally. The output - format mirrors gcloud ai-platform predict (online prediction). - - You cannot use this command with custom prediction routines. - -REQUIRED FLAGS - --model-dir=MODEL_DIR - Path to the model. - - Exactly one of these must be specified: - - --json-instances=JSON_INSTANCES - Path to a local file from which instances are read. Instances are in - JSON format; newline delimited. - - An example of the JSON instances file: - - {"images": [0.0, ..., 0.1], "key": 3} - {"images": [0.0, ..., 0.1], "key": 2} - ... - - This flag accepts "-" for stdin. - - --json-request=JSON_REQUEST - Path to a local file containing the body of JSON request. - - An example of a JSON request: - - { - "instances": [ - {"x": [1, 2], "y": [3, 4]}, - {"x": [-1, -2], "y": [-3, -4]} - ] - } - - This flag accepts "-" for stdin. - - --text-instances=TEXT_INSTANCES - Path to a local file from which instances are read. Instances are in - UTF-8 encoded text format; newline delimited. - - An example of the text instances file: - - 107,4.9,2.5,4.5,1.7 - 100,5.7,2.8,4.1,1.3 - ... - - This flag accepts "-" for stdin. - -OPTIONAL FLAGS - --framework=FRAMEWORK - ML framework used to train this version of the model. If not specified, - defaults to 'tensorflow'. FRAMEWORK must be one of: scikit-learn, - tensorflow, xgboost. - - --signature-name=SIGNATURE_NAME - Name of the signature defined in the SavedModel to use for this job. - Defaults to DEFAULT_SERVING_SIGNATURE_DEF_KEY in - https://www.tensorflow.org/api_docs/python/tf/compat/v1/saved_model/signature_constants, - which is "serving_default". Only applies to TensorFlow models. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine local predict - - $ gcloud alpha ml-engine local predict - diff --git a/gcloud/beta/ml-engine/local/train b/gcloud/beta/ml-engine/local/train deleted file mode 100644 index d97caed18..000000000 --- a/gcloud/beta/ml-engine/local/train +++ /dev/null @@ -1,108 +0,0 @@ -NAME - gcloud beta ml-engine local train - run an AI Platform training job locally - -SYNOPSIS - gcloud beta ml-engine local train --module-name=MODULE_NAME [--distributed] - [--evaluator-count=EVALUATOR_COUNT] [--job-dir=JOB_DIR] - [--package-path=PACKAGE_PATH] - [--parameter-server-count=PARAMETER_SERVER_COUNT] - [--start-port=START_PORT; default=27182] [--worker-count=WORKER_COUNT] - [GCLOUD_WIDE_FLAG ...] [-- USER_ARGS ...] - -DESCRIPTION - (BETA) This command runs the specified module in an environment similar to - that of a live AI Platform Training Job. - - This is especially useful in the case of testing distributed models, as it - allows you to validate that you are properly interacting with the AI - Platform cluster configuration. If your model expects a specific number of - parameter servers or workers (i.e. you expect to use the CUSTOM machine - type), use the --parameter-server-count and --worker-count flags to further - specify the desired cluster configuration, just as you would in your cloud - training job configuration: - - $ gcloud beta ml-engine local train --module-name trainer.task \ - --package-path /path/to/my/code/trainer \ - --distributed \ - --parameter-server-count 4 \ - --worker-count 8 - - Unlike submitting a training job, the --package-path parameter can be - omitted, and will use your current working directory. - - AI Platform Training sets a TF_CONFIG environment variable on each VM in - your training job. You can use TF_CONFIG to access the cluster description - and the task description for each VM. - - Learn more about TF_CONFIG: - https://cloud.google.com/ai-platform/training/docs/distributed-training-details. - -POSITIONAL ARGUMENTS - [-- USER_ARGS ...] - Additional user arguments to be forwarded to user code. Any relative - paths will be relative to the parent directory of --package-path. - - The '--' argument must be specified between gcloud specific args on the - left and USER_ARGS on the right. - -REQUIRED FLAGS - --module-name=MODULE_NAME - Name of the module to run. - -OPTIONAL FLAGS - --distributed - Runs the provided code in distributed mode by providing cluster - configurations as environment variables to subprocesses - - --evaluator-count=EVALUATOR_COUNT - Number of evaluators with which to run. Ignored if --distributed is not - specified. Default: 0 - - --job-dir=JOB_DIR - Cloud Storage path or local_directory in which to store training - outputs and other data needed for training. - - This path will be passed to your TensorFlow program as the --job-dir - command-line arg. The benefit of specifying this field is that AI - Platform will validate the path for use in training. However, note that - your training program will need to parse the provided --job-dir - argument. - - --package-path=PACKAGE_PATH - Path to a Python package to build. This should point to a local - directory containing the Python source for the job. It will be built - using setuptools (which must be installed) using its parent directory - as context. If the parent directory contains a setup.py file, the build - will use that; otherwise, it will use a simple built-in one. - - --parameter-server-count=PARAMETER_SERVER_COUNT - Number of parameter servers with which to run. Ignored if --distributed - is not specified. Default: 2 - - --start-port=START_PORT; default=27182 - Start of the range of ports reserved by the local cluster. This command - will use a contiguous block of ports equal to parameter-server-count + - worker-count + 1. - - If --distributed is not specified, this flag is ignored. - - --worker-count=WORKER_COUNT - Number of workers with which to run. Ignored if --distributed is not - specified. Default: 2 - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine local train - - $ gcloud alpha ml-engine local train - diff --git a/gcloud/beta/ml-engine/models/add-iam-policy-binding b/gcloud/beta/ml-engine/models/add-iam-policy-binding deleted file mode 100644 index 4b7766ed1..000000000 --- a/gcloud/beta/ml-engine/models/add-iam-policy-binding +++ /dev/null @@ -1,89 +0,0 @@ -NAME - gcloud beta ml-engine models add-iam-policy-binding - add IAM policy - binding for a model - -SYNOPSIS - gcloud beta ml-engine models add-iam-policy-binding MODEL - --member=PRINCIPAL --role=ROLE [--region=REGION] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Add IAM policy binding to a model. - -EXAMPLES - To add an IAM policy binding for the role of roles/ml.admin for the user - test-user@gmail.com on a model with identifier my_model, run: - - $ gcloud beta ml-engine models add-iam-policy-binding my_model \ - --member='user:test-user@gmail.com' --role='roles/ml.admin' - - To add an IAM policy binding for the role of roles/ml.admin to the service - account test-proj1@example.domain.com, run: - - $ gcloud beta ml-engine models add-iam-policy-binding my_model \ - --member='serviceAccount:test-proj1@example.domain.com' \ - --role='roles/ml.admin' - - To add an IAM policy binding for the role of roles/ml.admin for all - authenticated users on a model with identifier my_model, run: - - $ gcloud beta ml-engine models add-iam-policy-binding my_model \ - --member='allAuthenticatedUsers' --role='roles/ml.admin' - - See https://cloud.google.com/iam/docs/managing-policies for details of - policy role and principal types. - -POSITIONAL ARGUMENTS - MODEL - Name of the model. - -REQUIRED FLAGS - --member=PRINCIPAL - The principal to add the binding for. Should be of the form - user|group|serviceAccount:email or domain:domain. - - Examples: user:test-user@gmail.com, group:admins@example.com, - serviceAccount:test123@example.domain.com, or - domain:example.domain.com. - - Some resources also accept the following special values: - ◆ allUsers - Special identifier that represents anyone who is on the - internet, with or without a Google account. - ◆ allAuthenticatedUsers - Special identifier that represents anyone - who is authenticated with a Google account or a service account. - - --role=ROLE - Role name to assign to the principal. The role name is the complete - path of a predefined role, such as roles/logging.viewer, or the role ID - for a custom role, such as - organizations/{ORGANIZATION_ID}/roles/logging.viewer. - -OPTIONAL FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine models add-iam-policy-binding - - $ gcloud alpha ml-engine models add-iam-policy-binding - diff --git a/gcloud/beta/ml-engine/models/create b/gcloud/beta/ml-engine/models/create deleted file mode 100644 index c2e73b00e..000000000 --- a/gcloud/beta/ml-engine/models/create +++ /dev/null @@ -1,87 +0,0 @@ -NAME - gcloud beta ml-engine models create - create a new AI Platform model - -SYNOPSIS - gcloud beta ml-engine models create MODEL [--description=DESCRIPTION] - [--enable-console-logging] [--enable-logging] - [--labels=[KEY=VALUE,...]] - [--region=REGION | --regions=REGION,[REGION,...]] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Create a new AI Platform model. - -POSITIONAL ARGUMENTS - MODEL - Name of the model. - -FLAGS - --description=DESCRIPTION - Description of the model. - - --enable-console-logging - If set, enables StackDriver Logging of stderr and stdout streams for - online prediction. These logs are more verbose than the standard access - logs and can be helpful for debugging. - - --enable-logging - If set, enables StackDriver Logging for online prediction. These logs - are like standard server access logs, containing information such as - timestamps and latency for each request. - - --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 these can be specified: - - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - - If you specify this flag, do not specify --regions. - - If you specify --region=global, the model will be deployed to - 'us-central1' by default using the global endpoint. Please use - --regions only if you want to change the region where the model will - be deployed against the global endpoint. - - If both flags are unspecified and you don't set ai_platform/region, - you will be prompted for region of the regional endpoint. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - - --regions=REGION,[REGION,...] - The Google Cloud region where the model will be deployed (currently - only a single region is supported) against the global endpoint. - - If you specify this flag, do not specify --region. - - Defaults to 'us-central1' while using the global endpoint. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine models create - - $ gcloud alpha ml-engine models create - diff --git a/gcloud/beta/ml-engine/models/delete b/gcloud/beta/ml-engine/models/delete deleted file mode 100644 index c8739a603..000000000 --- a/gcloud/beta/ml-engine/models/delete +++ /dev/null @@ -1,48 +0,0 @@ -NAME - gcloud beta ml-engine models delete - delete an existing AI Platform model - -SYNOPSIS - gcloud beta ml-engine models delete MODEL [--region=REGION] - [GCLOUD_WIDE_FLAG ...] - -EXAMPLES - To delete all models matching the regular expression vision[0-9]+, run: - - $ gcloud beta ml-engine models list --uri \ - --filter 'name ~ vision[0-9]+' | xargs -n 1 gcloud beta \ - ml-engine models delete - -POSITIONAL ARGUMENTS - MODEL - Name of the model. - -FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine models delete - - $ gcloud alpha ml-engine models delete - diff --git a/gcloud/beta/ml-engine/models/describe b/gcloud/beta/ml-engine/models/describe deleted file mode 100644 index 888bd41e1..000000000 --- a/gcloud/beta/ml-engine/models/describe +++ /dev/null @@ -1,48 +0,0 @@ -NAME - gcloud beta ml-engine models describe - describe an existing AI Platform - model - -SYNOPSIS - gcloud beta ml-engine models describe MODEL [--region=REGION] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Describe an existing AI Platform model. - - If you would like to see all versions of a model, use gcloud ai-platform - versions list. - -POSITIONAL ARGUMENTS - MODEL - Name of the model. - -FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine models describe - - $ gcloud alpha ml-engine models describe - diff --git a/gcloud/beta/ml-engine/models/get-iam-policy b/gcloud/beta/ml-engine/models/get-iam-policy deleted file mode 100644 index 9265d74c7..000000000 --- a/gcloud/beta/ml-engine/models/get-iam-policy +++ /dev/null @@ -1,94 +0,0 @@ -NAME - gcloud beta ml-engine models get-iam-policy - get the IAM policy for a - model - -SYNOPSIS - gcloud beta ml-engine models get-iam-policy MODEL [--region=REGION] - [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] - [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Gets the IAM policy for the given model. - - Returns an empty policy if the resource does not have a policy set. - -EXAMPLES - The following command gets the IAM policy for the model my_model: - - $ gcloud beta ml-engine models get-iam-policy my_model - -POSITIONAL ARGUMENTS - Model resource - The AI Platform model to set IAM policy for. 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 model 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. - - MODEL - ID of the model or fully qualified identifier for the model. - - To set the name attribute: - ▸ provide the argument model on the command line. - -FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - -LIST COMMAND FLAGS - --filter=EXPRESSION - Apply a Boolean filter EXPRESSION to each resource item to be listed. - If the expression evaluates True, then that item is listed. For more - details and examples of filter expressions, run $ gcloud topic filters. - This flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --limit=LIMIT - Maximum number of resources to list. The default is unlimited. This - flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --page-size=PAGE_SIZE - Some services group resource list output into pages. This flag - specifies the maximum number of resources per page. The default is - determined by the service if it supports paging, otherwise it is - unlimited (no paging). Paging may be applied before or after --filter - and --limit depending on the service. - - --sort-by=[FIELD,...] - Comma-separated list of resource field key names to sort by. The - default order is ascending. Prefix a field with ``~'' for descending - order on that field. This flag interacts with other flags that are - applied in this order: --flatten, --sort-by, --filter, --limit. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud ml-engine models get-iam-policy - - $ gcloud alpha ml-engine models get-iam-policy - diff --git a/gcloud/beta/ml-engine/models/help b/gcloud/beta/ml-engine/models/help deleted file mode 100644 index 739e5257f..000000000 --- a/gcloud/beta/ml-engine/models/help +++ /dev/null @@ -1,59 +0,0 @@ -NAME - gcloud beta ml-engine models - AI Platform Models commands - -SYNOPSIS - gcloud beta ml-engine models COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) An AI Platform model is a container representing an ML application - or service. A model may contain multiple versions which act as the - implementation of the service. See also: - - $ gcloud beta ml-engine versions --help. - - For more information, please see - https://cloud.google.com/ml/docs/concepts/technical-overview#model - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -COMMANDS - COMMAND is one of the following: - - add-iam-policy-binding - (BETA) Add IAM policy binding for a model. - - create - (BETA) Create a new AI Platform model. - - delete - (BETA) Delete an existing AI Platform model. - - describe - (BETA) Describe an existing AI Platform model. - - get-iam-policy - (BETA) Get the IAM policy for a model. - - list - (BETA) List existing AI Platform models. - - remove-iam-policy-binding - (BETA) Remove IAM policy binding for a model. - - set-iam-policy - (BETA) Set the IAM policy for a model. - - update - (BETA) Update an existing AI Platform model. - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud ml-engine models - - $ gcloud alpha ml-engine models - diff --git a/gcloud/beta/ml-engine/models/list b/gcloud/beta/ml-engine/models/list deleted file mode 100644 index 4ec1b9860..000000000 --- a/gcloud/beta/ml-engine/models/list +++ /dev/null @@ -1,73 +0,0 @@ -NAME - gcloud beta ml-engine models list - list existing AI Platform models - -SYNOPSIS - gcloud beta ml-engine models list [--region=REGION] [--filter=EXPRESSION] - [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) List existing AI Platform models. - -FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - -LIST COMMAND FLAGS - --filter=EXPRESSION - Apply a Boolean filter EXPRESSION to each resource item to be listed. - If the expression evaluates True, then that item is listed. For more - details and examples of filter expressions, run $ gcloud topic filters. - This flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --limit=LIMIT - Maximum number of resources to list. The default is unlimited. This - flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --page-size=PAGE_SIZE - Some services group resource list output into pages. This flag - specifies the maximum number of resources per page. The default is - determined by the service if it supports paging, otherwise it is - unlimited (no paging). Paging may be applied before or after --filter - and --limit depending on the service. - - --sort-by=[FIELD,...] - Comma-separated list of resource field key names to sort by. The - default order is ascending. Prefix a field with ``~'' for descending - order on that field. This flag interacts with other flags that are - applied in this order: --flatten, --sort-by, --filter, --limit. - - --uri - Print a list of resource URIs instead of the default output, and change - the command output to a list of URIs. If this flag is used with - --format, the formatting is applied on this URI list. To display URIs - alongside other keys instead, use the uri() transform. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud ml-engine models list - - $ gcloud alpha ml-engine models list - diff --git a/gcloud/beta/ml-engine/models/remove-iam-policy-binding b/gcloud/beta/ml-engine/models/remove-iam-policy-binding deleted file mode 100644 index e9070e8e9..000000000 --- a/gcloud/beta/ml-engine/models/remove-iam-policy-binding +++ /dev/null @@ -1,101 +0,0 @@ -NAME - gcloud beta ml-engine models remove-iam-policy-binding - remove IAM policy - binding for a model - -SYNOPSIS - gcloud beta ml-engine models remove-iam-policy-binding MODEL - --member=PRINCIPAL --role=ROLE [--region=REGION] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Removes a policy binding from an AI Platform Model. One binding - consists of a member, a role and an optional condition. See $ gcloud beta - ml-engine models get-iam-policy for examples of how to specify a model - resource. - -EXAMPLES - To remove an IAM policy binding for the role of roles/ml.admin for the user - test-user@gmail.com on model with identifier my_model, run: - - $ gcloud beta ml-engine models remove-iam-policy-binding my_model \ - --member='user:test-user@gmail.com' --role='roles/ml.admin' - - To remove an IAM policy binding for the role of roles/ml.admin from all - authenticated users on model my_model, run: - - $ gcloud beta ml-engine models remove-iam-policy-binding my_model \ - --member='allAuthenticatedUsers' --role='roles/ml.admin' - - See https://cloud.google.com/iam/docs/managing-policies for details of - policy role and member types. - -POSITIONAL ARGUMENTS - Model resource - The AI Platform model for which to remove IAM policy - binding from. 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 model 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. - - MODEL - ID of the model or fully qualified identifier for the model. - - To set the name attribute: - ▸ provide the argument model on the command line. - -REQUIRED FLAGS - --member=PRINCIPAL - The principal to remove the binding for. Should be of the form - user|group|serviceAccount:email or domain:domain. - - Examples: user:test-user@gmail.com, group:admins@example.com, - serviceAccount:test123@example.domain.com, or - domain:example.domain.com. - - Deleted principals have an additional deleted: prefix and a ?uid=UID - suffix, where UID is a unique identifier for the principal. Example: - deleted:user:test-user@gmail.com?uid=123456789012345678901. - - Some resources also accept the following special values: - ◆ allUsers - Special identifier that represents anyone who is on the - internet, with or without a Google account. - ◆ allAuthenticatedUsers - Special identifier that represents anyone - who is authenticated with a Google account or a service account. - - --role=ROLE - The role to remove the principal from. - -OPTIONAL FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine models remove-iam-policy-binding - - $ gcloud alpha ml-engine models remove-iam-policy-binding - diff --git a/gcloud/beta/ml-engine/models/set-iam-policy b/gcloud/beta/ml-engine/models/set-iam-policy deleted file mode 100644 index 8d521dd3c..000000000 --- a/gcloud/beta/ml-engine/models/set-iam-policy +++ /dev/null @@ -1,77 +0,0 @@ -NAME - gcloud beta ml-engine models set-iam-policy - set the IAM policy for a - model - -SYNOPSIS - gcloud beta ml-engine models set-iam-policy MODEL POLICY_FILE - [--region=REGION] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Sets the IAM policy for the given model as defined in a JSON or YAML - file. - - See https://cloud.google.com/iam/docs/managing-policies for details of the - policy file format and contents. - -EXAMPLES - The following command will read am IAM policy defined in a JSON file - 'policy.json' and set it for the model my_model: - - $ gcloud beta ml-engine models set-iam-policy my_model policy.json - -POSITIONAL ARGUMENTS - Model resource - The AI Platform model to set IAM policy for. 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 model 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. - - MODEL - ID of the model or fully qualified identifier for the model. - - To set the name attribute: - ▸ provide the argument model on the command line. - - POLICY_FILE - Path to a local JSON or YAML formatted file containing a valid policy. - - The output of the get-iam-policy command is a valid file, as is any - JSON or YAML file conforming to the structure of a Policy - (https://cloud.google.com/iam/reference/rest/v1/Policy). - -FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine models set-iam-policy - - $ gcloud alpha ml-engine models set-iam-policy - diff --git a/gcloud/beta/ml-engine/models/update b/gcloud/beta/ml-engine/models/update deleted file mode 100644 index 882c406b1..000000000 --- a/gcloud/beta/ml-engine/models/update +++ /dev/null @@ -1,77 +0,0 @@ -NAME - gcloud beta ml-engine models update - update an existing AI Platform model - -SYNOPSIS - gcloud beta ml-engine models update MODEL [--description=DESCRIPTION] - [--region=REGION] [--update-labels=[KEY=VALUE,...]] - [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Update an existing AI Platform model. - -POSITIONAL ARGUMENTS - MODEL - Name of the model. - -FLAGS - --description=DESCRIPTION - Description of the model. - - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - - --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 ml-engine models update --clear-labels - - To remove all existing labels and create two new labels, foo and baz: - - $ gcloud beta ml-engine models 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. These - variants are also available: - - $ gcloud ml-engine models update - - $ gcloud alpha ml-engine models update - diff --git a/gcloud/beta/ml-engine/operations/cancel b/gcloud/beta/ml-engine/operations/cancel deleted file mode 100644 index 47363dcb0..000000000 --- a/gcloud/beta/ml-engine/operations/cancel +++ /dev/null @@ -1,45 +0,0 @@ -NAME - gcloud beta ml-engine operations cancel - cancel an AI Platform operation - -SYNOPSIS - gcloud beta ml-engine operations cancel OPERATION [--region=REGION] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Cancel an AI Platform operation. - -POSITIONAL ARGUMENTS - OPERATION - Name of the operation. - -FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - If unspecified, the command uses the global endpoint of the AI Platform - Training and Prediction API. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: asia-east1, asia-northeast1, asia-southeast1, - australia-southeast1, europe-west1, europe-west2, europe-west3, - europe-west4, northamerica-northeast1, us-central1, us-east1, us-east4, - us-west1. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine operations cancel - - $ gcloud alpha ml-engine operations cancel - diff --git a/gcloud/beta/ml-engine/operations/describe b/gcloud/beta/ml-engine/operations/describe deleted file mode 100644 index 6d352f493..000000000 --- a/gcloud/beta/ml-engine/operations/describe +++ /dev/null @@ -1,46 +0,0 @@ -NAME - gcloud beta ml-engine operations describe - describe an AI Platform - operation - -SYNOPSIS - gcloud beta ml-engine operations describe OPERATION [--region=REGION] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Describe an AI Platform operation. - -POSITIONAL ARGUMENTS - OPERATION - Name of the operation. - -FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - If unspecified, the command uses the global endpoint of the AI Platform - Training and Prediction API. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: asia-east1, asia-northeast1, asia-southeast1, - australia-southeast1, europe-west1, europe-west2, europe-west3, - europe-west4, northamerica-northeast1, us-central1, us-east1, us-east4, - us-west1. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine operations describe - - $ gcloud alpha ml-engine operations describe - diff --git a/gcloud/beta/ml-engine/operations/help b/gcloud/beta/ml-engine/operations/help deleted file mode 100644 index fe2c4f5e8..000000000 --- a/gcloud/beta/ml-engine/operations/help +++ /dev/null @@ -1,37 +0,0 @@ -NAME - gcloud beta ml-engine operations - manage AI Platform operations - -SYNOPSIS - gcloud beta ml-engine operations COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Manage AI Platform operations. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -COMMANDS - COMMAND is one of the following: - - cancel - (BETA) Cancel an AI Platform operation. - - describe - (BETA) Describe an AI Platform operation. - - list - (BETA) List existing AI Platform jobs. - - wait - (BETA) Wait for an AI Platform operation to complete. - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud ml-engine operations - - $ gcloud alpha ml-engine operations - diff --git a/gcloud/beta/ml-engine/operations/wait b/gcloud/beta/ml-engine/operations/wait deleted file mode 100644 index f6836b44d..000000000 --- a/gcloud/beta/ml-engine/operations/wait +++ /dev/null @@ -1,50 +0,0 @@ -NAME - gcloud beta ml-engine operations wait - wait for an AI Platform operation - to complete - -SYNOPSIS - gcloud beta ml-engine operations wait OPERATION [--region=REGION] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Wait for an AI Platform operation to complete. - - Given an operation ID, this command polls the operation and blocks until it - completes. At completion, the operation message is printed (which includes - the operation response). - -POSITIONAL ARGUMENTS - OPERATION - Name of the operation. - -FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - If unspecified, the command uses the global endpoint of the AI Platform - Training and Prediction API. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: asia-east1, asia-northeast1, asia-southeast1, - australia-southeast1, europe-west1, europe-west2, europe-west3, - europe-west4, northamerica-northeast1, us-central1, us-east1, us-east4, - us-west1. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine operations wait - - $ gcloud alpha ml-engine operations wait - diff --git a/gcloud/beta/ml-engine/predict b/gcloud/beta/ml-engine/predict deleted file mode 100644 index 81274188f..000000000 --- a/gcloud/beta/ml-engine/predict +++ /dev/null @@ -1,107 +0,0 @@ -NAME - gcloud beta ml-engine predict - run AI Platform online prediction - -SYNOPSIS - gcloud beta ml-engine predict --model=MODEL - (--json-instances=JSON_INSTANCES | --json-request=JSON_REQUEST - | --text-instances=TEXT_INSTANCES) [--region=REGION] - [--signature-name=SIGNATURE_NAME] [--version=VERSION] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) gcloud beta ml-engine predict sends a prediction request to AI - Platform for the given instances. This command will read up to 100 - instances, though the service itself will accept instances up to the - payload limit size (currently, 1.5MB). If you are predicting on more - instances, you should use batch prediction via - - $ gcloud beta ml-engine jobs submit prediction. - -REQUIRED FLAGS - --model=MODEL - Name of the model. - - Exactly one of these must be specified: - - --json-instances=JSON_INSTANCES - Path to a local file from which instances are read. Instances are in - JSON format; newline delimited. - - An example of the JSON instances file: - - {"images": [0.0, ..., 0.1], "key": 3} - {"images": [0.0, ..., 0.1], "key": 2} - ... - - This flag accepts "-" for stdin. - - --json-request=JSON_REQUEST - Path to a local file containing the body of JSON request. - - An example of a JSON request: - - { - "instances": [ - {"x": [1, 2], "y": [3, 4]}, - {"x": [-1, -2], "y": [-3, -4]} - ] - } - - This flag accepts "-" for stdin. - - --text-instances=TEXT_INSTANCES - Path to a local file from which instances are read. Instances are in - UTF-8 encoded text format; newline delimited. - - An example of the text instances file: - - 107,4.9,2.5,4.5,1.7 - 100,5.7,2.8,4.1,1.3 - ... - - This flag accepts "-" for stdin. - -OPTIONAL FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - - --signature-name=SIGNATURE_NAME - Name of the signature defined in the SavedModel to use for this job. - Defaults to DEFAULT_SERVING_SIGNATURE_DEF_KEY in - https://www.tensorflow.org/api_docs/python/tf/compat/v1/saved_model/signature_constants, - which is "serving_default". Only applies to TensorFlow models. - - --version=VERSION - Model version to be used. - - If unspecified, the default version of the model will be used. To list - model versions run - - $ gcloud beta ml-engine versions list - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud ml-engine predict - - $ gcloud alpha ml-engine predict - diff --git a/gcloud/beta/ml-engine/versions/create b/gcloud/beta/ml-engine/versions/create deleted file mode 100644 index 985068c7d..000000000 --- a/gcloud/beta/ml-engine/versions/create +++ /dev/null @@ -1,258 +0,0 @@ -NAME - gcloud beta ml-engine versions create - create a new AI Platform version - -SYNOPSIS - gcloud beta ml-engine versions create VERSION --model=MODEL - [--accelerator=[count=COUNT],[type=TYPE]] [--async] [--config=CONFIG] - [--description=DESCRIPTION] [--explanation-method=EXPLANATION_METHOD] - [--framework=FRAMEWORK] [--labels=[KEY=VALUE,...]] - [--machine-type=MACHINE_TYPE] - [--num-integral-steps=NUM_INTEGRAL_STEPS; default=50] - [--num-paths=NUM_PATHS; default=50] [--origin=ORIGIN] - [--python-version=PYTHON_VERSION] [--region=REGION] - [--runtime-version=RUNTIME_VERSION] [--service-account=SERVICE_ACCOUNT] - [--staging-bucket=STAGING_BUCKET] - [--args=[ARG,...] --command=[COMMAND,...] - --env-vars=[KEY=VALUE,...] --image=IMAGE --ports=[ARG,...]] - [--health-route=HEALTH_ROUTE --predict-route=PREDICT_ROUTE] - [--max-nodes=MAX_NODES - --metric-targets=[METRIC-NAME=TARGET,...] --min-nodes=MIN_NODES] - [--package-uris=[PACKAGE_URI,...] --prediction-class=PREDICTION_CLASS] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Creates a new version of an AI Platform model. - - For more details on managing AI Platform models and versions see - https://cloud.google.com/ai-platform/prediction/docs/managing-models-jobs - -EXAMPLES - To create an AI Platform version model with the version ID 'versionId' and - with the name 'model-name', run: - - $ gcloud beta ml-engine versions create versionId --model=model-name - -POSITIONAL ARGUMENTS - VERSION - Name of the model version. - -REQUIRED FLAGS - --model=MODEL - Name of the model. - -OPTIONAL FLAGS - --accelerator=[count=COUNT],[type=TYPE] - Manage the accelerator config for GPU serving. When deploying a model - with Compute Engine Machine Types, a GPU accelerator may also be - selected. - - type - The type of the accelerator. Choices are 'nvidia-tesla-a100', - 'nvidia-tesla-k80', 'nvidia-tesla-p100', 'nvidia-tesla-p4', - 'nvidia-tesla-t4', 'nvidia-tesla-v100'. - - count - The number of accelerators to attach to each machine running the - job. If not specified, the default value is 1. Your model must be - specially designed to accommodate more than 1 accelerator per - machine. To configure how many replicas your model has, set the - manualScaling or autoScaling parameters. - - --async - Return immediately, without waiting for the operation in progress to - complete. - - --config=CONFIG - Path to a YAML configuration file containing configuration parameters - for the Version - (https://cloud.google.com/ai-platform/prediction/docs/reference/rest/v1/projects.models.versions) - to create. - - The file is in YAML format. Note that not all attributes of a version - are configurable; available attributes (with example values) are: - - description: A free-form description of the version. - deploymentUri: gs://path/to/source - runtimeVersion: '2.1' - # Set only one of either manualScaling or autoScaling. - manualScaling: - nodes: 10 # The number of nodes to allocate for this model. - autoScaling: - minNodes: 0 # The minimum number of nodes to allocate for this model. - labels: - user-defined-key: user-defined-value - - The name of the version must always be specified via the required - VERSION argument. - - Only one of manualScaling or autoScaling can be specified. If both are - specified in same yaml file an error will be returned. - - If an option is specified both in the configuration file and via - command-line arguments, the command-line arguments override the - configuration file. - - --description=DESCRIPTION - Description of the version. - - --explanation-method=EXPLANATION_METHOD - Enable explanations and select the explanation method to use. - - The valid options are: integrated-gradients: Use Integrated Gradients. - sampled-shapley: Use Sampled Shapley. xrai: Use XRAI. - - EXPLANATION_METHOD must be one of: integrated-gradients, - sampled-shapley, xrai. - - --framework=FRAMEWORK - ML framework used to train this version of the model. If not specified, - defaults to 'tensorflow'. FRAMEWORK must be one of: scikit-learn, - tensorflow, xgboost. - - --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. - - --machine-type=MACHINE_TYPE - Type of machine on which to serve the model. Currently only applies to - online prediction. For available machine types, see - https://cloud.google.com/ai-platform/prediction/docs/machine-types-online-prediction#available_machine_types. - - --num-integral-steps=NUM_INTEGRAL_STEPS; default=50 - Number of integral steps for Integrated Gradients. Only valid when - --explanation-method=integrated-gradients or --explanation-method=xrai - is specified. - - --num-paths=NUM_PATHS; default=50 - Number of paths for Sampled Shapley. Only valid when - --explanation-method=sampled-shapley is specified. - - --origin=ORIGIN - Location of model/ "directory" (see - https://cloud.google.com/ai-platform/prediction/docs/deploying-models#upload-model). - - This overrides deploymentUri in the --config file. If this flag is not - passed, deploymentUri must be specified in the file from --config. - - Can be a Cloud Storage (gs://) path or local file path (no prefix). In - the latter case the files will be uploaded to Cloud Storage and a - --staging-bucket argument is required. - - --python-version=PYTHON_VERSION - Version of Python used when creating the version. Choices are 3.7, 3.5, - and 2.7. However, this value must be compatible with the chosen runtime - version for the job. - - Must be used with a compatible runtime version: - - ◆ 3.7 is compatible with runtime versions 1.15 and later. - ◆ 3.5 is compatible with runtime versions 1.4 through 1.14. - ◆ 2.7 is compatible with runtime versions 1.15 and earlier. - - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - - --runtime-version=RUNTIME_VERSION - AI Platform runtime version for this job. Must be specified unless - --master-image-uri is specified instead. It is defined in documentation - along with the list of supported versions: - https://cloud.google.com/ai-platform/prediction/docs/runtime-version-list - - --service-account=SERVICE_ACCOUNT - Specifies the service account for resource access control. - - --staging-bucket=STAGING_BUCKET - Bucket in which to stage training archives. - - Required only if a file upload is necessary (that is, other flags - include local paths) and no other flags implicitly specify an upload - path. - - Configure the container to be deployed. - - --args=[ARG,...] - Comma-separated arguments passed to the command run by the container - image. If not specified and no '--command' is provided, the container - image's default Cmd is used. - - --command=[COMMAND,...] - Entrypoint for the container image. If not specified, the container - image's default Entrypoint is run. - - --env-vars=[KEY=VALUE,...] - List of key-value pairs to set as environment variables. - - --image=IMAGE - Name of the container image to deploy (e.g. - gcr.io/myproject/server:latest). - - --ports=[ARG,...] - Container ports to receive requests at. Must be a number between 1 - and 65535, inclusive. - - Flags to control the paths that requests and health checks are sent to. - - --health-route=HEALTH_ROUTE - HTTP path to send health checks to inside the container. - - --predict-route=PREDICT_ROUTE - HTTP path to send prediction requests to inside the container. - - Configure the autoscaling settings to be deployed. - - --max-nodes=MAX_NODES - The maximum number of nodes to scale this model under load. - - --metric-targets=[METRIC-NAME=TARGET,...] - List of key-value pairs to set as metrics' target for autoscaling. - Autoscaling could be based on CPU usage or GPU duty cycle, valid key - could be cpu-usage or gpu-duty-cycle. - - --min-nodes=MIN_NODES - The minimum number of nodes to scale this model under load. - - Configure user code in prediction. - - AI Platform allows a model to have user-provided prediction - code; these options configure that code. - - --package-uris=[PACKAGE_URI,...] - Comma-separated list of Cloud Storage URIs ('gs://...') for - user-supplied Python packages to use. - - --prediction-class=PREDICTION_CLASS - Fully-qualified name of the custom prediction class in the package - provided for custom prediction. - - For example, --prediction-class=my_package.SequenceModel. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine versions create - - $ gcloud alpha ml-engine versions create - diff --git a/gcloud/beta/ml-engine/versions/delete b/gcloud/beta/ml-engine/versions/delete deleted file mode 100644 index 171075900..000000000 --- a/gcloud/beta/ml-engine/versions/delete +++ /dev/null @@ -1,49 +0,0 @@ -NAME - gcloud beta ml-engine versions delete - delete an existing AI Platform - version - -SYNOPSIS - gcloud beta ml-engine versions delete VERSION --model=MODEL - [--region=REGION] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Delete an existing AI Platform version. - -POSITIONAL ARGUMENTS - VERSION - Name of the model version. - -REQUIRED FLAGS - --model=MODEL - Name of the model. - -OPTIONAL FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine versions delete - - $ gcloud alpha ml-engine versions delete - diff --git a/gcloud/beta/ml-engine/versions/describe b/gcloud/beta/ml-engine/versions/describe deleted file mode 100644 index 4aaef1bac..000000000 --- a/gcloud/beta/ml-engine/versions/describe +++ /dev/null @@ -1,49 +0,0 @@ -NAME - gcloud beta ml-engine versions describe - describe an existing AI Platform - version - -SYNOPSIS - gcloud beta ml-engine versions describe VERSION --model=MODEL - [--region=REGION] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Describe an existing AI Platform version. - -POSITIONAL ARGUMENTS - VERSION - Name of the model version. - -REQUIRED FLAGS - --model=MODEL - Name of the model. - -OPTIONAL FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine versions describe - - $ gcloud alpha ml-engine versions describe - diff --git a/gcloud/beta/ml-engine/versions/help b/gcloud/beta/ml-engine/versions/help deleted file mode 100644 index a9013350d..000000000 --- a/gcloud/beta/ml-engine/versions/help +++ /dev/null @@ -1,49 +0,0 @@ -NAME - gcloud beta ml-engine versions - AI Platform Versions commands - -SYNOPSIS - gcloud beta ml-engine versions COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) A version is an implementation of a model, represented as a - serialized TensorFlow graph with trained parameters. - - When you communicate with AI Platform services, you use the combination of - the model, version, and current project to identify a specific model - implementation that is deployed in the cloud. - -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 new AI Platform version. - - delete - (BETA) Delete an existing AI Platform version. - - describe - (BETA) Describe an existing AI Platform version. - - list - (BETA) List existing AI Platform versions. - - set-default - (BETA) Sets an existing AI Platform version as the default for its - model. - - update - (BETA) Update an AI Platform version. - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud ml-engine versions - - $ gcloud alpha ml-engine versions - diff --git a/gcloud/beta/ml-engine/versions/list b/gcloud/beta/ml-engine/versions/list deleted file mode 100644 index 89ae87ac9..000000000 --- a/gcloud/beta/ml-engine/versions/list +++ /dev/null @@ -1,77 +0,0 @@ -NAME - gcloud beta ml-engine versions list - list existing AI Platform versions - -SYNOPSIS - gcloud beta ml-engine versions list --model=MODEL [--region=REGION] - [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] - [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) List existing AI Platform versions. - -REQUIRED FLAGS - --model=MODEL - Name of the model. - -FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - -LIST COMMAND FLAGS - --filter=EXPRESSION - Apply a Boolean filter EXPRESSION to each resource item to be listed. - If the expression evaluates True, then that item is listed. For more - details and examples of filter expressions, run $ gcloud topic filters. - This flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --limit=LIMIT - Maximum number of resources to list. The default is unlimited. This - flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --page-size=PAGE_SIZE - Some services group resource list output into pages. This flag - specifies the maximum number of resources per page. The default is - determined by the service if it supports paging, otherwise it is - unlimited (no paging). Paging may be applied before or after --filter - and --limit depending on the service. - - --sort-by=[FIELD,...] - Comma-separated list of resource field key names to sort by. The - default order is ascending. Prefix a field with ``~'' for descending - order on that field. This flag interacts with other flags that are - applied in this order: --flatten, --sort-by, --filter, --limit. - - --uri - Print a list of resource URIs instead of the default output, and change - the command output to a list of URIs. If this flag is used with - --format, the formatting is applied on this URI list. To display URIs - alongside other keys instead, use the uri() transform. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud ml-engine versions list - - $ gcloud alpha ml-engine versions list - diff --git a/gcloud/beta/ml-engine/versions/set-default b/gcloud/beta/ml-engine/versions/set-default deleted file mode 100644 index e9f2c4df2..000000000 --- a/gcloud/beta/ml-engine/versions/set-default +++ /dev/null @@ -1,53 +0,0 @@ -NAME - gcloud beta ml-engine versions set-default - sets an existing AI Platform - version as the default for its model - -SYNOPSIS - gcloud beta ml-engine versions set-default VERSION --model=MODEL - [--region=REGION] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Sets an existing AI Platform version as the default for its model. - - gcloud beta ml-engine versions set-default sets an existing AI Platform - version as the default for its model. Only one version may be the default - for a given version. - -POSITIONAL ARGUMENTS - VERSION - Name of the model version. - -REQUIRED FLAGS - --model=MODEL - Name of the model. - -OPTIONAL FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine versions set-default - - $ gcloud alpha ml-engine versions set-default - diff --git a/gcloud/beta/ml-engine/versions/update b/gcloud/beta/ml-engine/versions/update deleted file mode 100644 index 5e1c9840f..000000000 --- a/gcloud/beta/ml-engine/versions/update +++ /dev/null @@ -1,150 +0,0 @@ -NAME - gcloud beta ml-engine versions update - update an AI Platform version - -SYNOPSIS - gcloud beta ml-engine versions update (VERSION : --model=MODEL) - [--config=YAML_FILE] [--description=DESCRIPTION] [--region=REGION] - [--update-labels=[KEY=VALUE,...]] - [--bigquery-table-name=BIGQUERY_TABLE_NAME - --sampling-percentage=SAMPLING_PERCENTAGE] - [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Update an AI Platform version. - -POSITIONAL ARGUMENTS - Version resource - The AI Platform model 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 version 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. - - VERSION - ID of the version or fully qualified identifier for the version. - - To set the version attribute: - ▸ provide the argument version on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --model=MODEL - Model for the version. - - To set the model attribute: - ▸ provide the argument version on the command line with a fully - specified name; - ▸ provide the argument --model on the command line. - -FLAGS - --config=YAML_FILE - Path to a YAML configuration file containing configuration parameters - for the version - (https://cloud.google.com/ml/reference/rest/v1/projects.models.versions) - to create. - - The file is in YAML format. Note that not all attributes of a version - are configurable; available attributes (with example values) are: - - description: A free-form description of the version. - manualScaling: - nodes: 10 # The number of nodes to allocate for this model. - autoScaling: - minNodes: 0 # The minimum number of nodes to allocate for this model. - maxNodes: 1 # The maxinum number of nodes to allocate for this model. - requestLoggingconfig: - bigqueryTableName: someTable # Fully qualified BigQuery table name. - samplingPercentage: 0.5 # Percentage of requests to be logged. - - The name of the version must always be specified via the required - VERSION argument. - - Only one of manualScaling or autoScaling can be specified. If both are - specified in same yaml file, an error will be returned. - - Labels cannot currently be set in the config.yaml; please use the - command-line flags to alter them. - - If an option is specified both in the configuration file and via - command-line arguments, the command-line arguments override the - configuration file. - - --description=DESCRIPTION - Description of the version. - - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - - --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. - - Configure request response logging. - - --bigquery-table-name=BIGQUERY_TABLE_NAME - Fully qualified name (project_id.dataset_name.table_name) of the - BigQuery table where requests and responses are logged. - - --sampling-percentage=SAMPLING_PERCENTAGE - Percentage of requests to be logged, expressed as a number between 0 - and 1. For example, set this value to 1 in order to log all requests - or to 0.1 to log 10% of requests. - - 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 ml-engine versions update --clear-labels - - To remove all existing labels and create two new labels, foo and baz: - - $ gcloud beta ml-engine versions 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. These - variants are also available: - - $ gcloud ml-engine versions update - - $ gcloud alpha ml-engine versions update - diff --git a/gcloud/beta/netapp/volumes/create b/gcloud/beta/netapp/volumes/create index 74c2b39d2..06525688a 100644 --- a/gcloud/beta/netapp/volumes/create +++ b/gcloud/beta/netapp/volumes/create @@ -42,6 +42,7 @@ SYNOPSIS [--snapshot-weekly=[day=DAY], [hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP]] [--source-snapshot=SOURCE_SNAPSHOT] + [--throughput-mibps=THROUGHPUT_MIBPS] [--tiering-policy=[tier-action=ENABLED|PAUSED,...]] [--unix-permissions=UNIX_PERMISSIONS] [--source-backup=SOURCE_BACKUP : --backup_vault=BACKUP_VAULT] @@ -289,6 +290,9 @@ OPTIONAL FLAGS To set the snapshot attribute: ▸ provide the argument --source-snapshot on the command line. + --throughput-mibps=THROUGHPUT_MIBPS + The desired throughput of the volume in MiB/s. + --tiering-policy=[tier-action=ENABLED|PAUSED,...] Tiering Policy contains auto tiering policy on a volume. diff --git a/gcloud/beta/netapp/volumes/update b/gcloud/beta/netapp/volumes/update index de90f63e4..17826742e 100644 --- a/gcloud/beta/netapp/volumes/update +++ b/gcloud/beta/netapp/volumes/update @@ -32,6 +32,7 @@ SYNOPSIS [--snapshot-weekly=[day=DAY], [hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP]] [--source-snapshot=SOURCE_SNAPSHOT] [--storage-pool=STORAGE_POOL] + [--throughput-mibps=THROUGHPUT_MIBPS] [--tiering-policy=[tier-action=ENABLED|PAUSED,...]] [--unix-permissions=UNIX_PERMISSIONS] [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] @@ -221,6 +222,9 @@ FLAGS To set the storage_pool attribute: ▸ provide the argument --storage-pool on the command line. + --throughput-mibps=THROUGHPUT_MIBPS + The desired throughput of the volume in MiB/s. + --tiering-policy=[tier-action=ENABLED|PAUSED,...] Tiering Policy contains auto tiering policy on a volume. diff --git a/gcloud/compute/firewall-policies/rules/create b/gcloud/compute/firewall-policies/rules/create index 684d9acfe..3f2b07578 100644 --- a/gcloud/compute/firewall-policies/rules/create +++ b/gcloud/compute/firewall-policies/rules/create @@ -4,13 +4,14 @@ NAME SYNOPSIS gcloud compute firewall-policies rules create PRIORITY --action=ACTION - --firewall-policy=FIREWALL_POLICY [--description=DESCRIPTION] + --firewall-policy=FIREWALL_POLICY --layer4-configs=[LAYER4_CONFIG,...] + [--description=DESCRIPTION] [--dest-address-groups=[DEST_ADDRESS_GROUPS,...]] [--dest-fqdns=[DEST_FQDNS,...]] [--dest-ip-ranges=[DEST_IP_RANGE,...]] [--dest-region-codes=[DEST_REGION_CODES,...]] [--dest-threat-intelligence=[DEST_THREAT_INTELLIGENCE_LISTS,...]] [--direction=DIRECTION] [--[no-]disabled] [--[no-]enable-logging] - [--layer4-configs=[LAYER4_CONFIG,...]] [--organization=ORGANIZATION] + [--organization=ORGANIZATION] [--security-profile-group=SECURITY_PROFILE_GROUP] [--src-address-groups=[SOURCE_ADDRESS_GROUPS,...]] [--src-fqdns=[SOURCE_FQDNS,...]] [--src-ip-ranges=[SRC_IP_RANGE,...]] @@ -47,6 +48,10 @@ REQUIRED FLAGS Short name of the firewall policy into which the rule should be inserted. + --layer4-configs=[LAYER4_CONFIG,...] + A list of destination protocols and ports to which the firewall rule + will apply. + OPTIONAL FLAGS --description=DESCRIPTION An optional, textual description for the rule. @@ -85,10 +90,6 @@ OPTIONAL FLAGS by this rule. Use --enable-logging to enable and --no-enable-logging to disable. - --layer4-configs=[LAYER4_CONFIG,...] - A list of destination protocols and ports to which the firewall rule - will apply. - --organization=ORGANIZATION Organization which the organization firewall policy belongs to. Must be set if FIREWALL_POLICY is short name. diff --git a/gcloud/compute/network-firewall-policies/mirroring-rules/create b/gcloud/compute/network-firewall-policies/mirroring-rules/create index c1609f09b..da330ccf0 100644 --- a/gcloud/compute/network-firewall-policies/mirroring-rules/create +++ b/gcloud/compute/network-firewall-policies/mirroring-rules/create @@ -5,9 +5,9 @@ NAME SYNOPSIS gcloud compute network-firewall-policies mirroring-rules create PRIORITY --action=ACTION --firewall-policy=FIREWALL_POLICY - --global-firewall-policy [--description=DESCRIPTION] - [--dest-ip-ranges=[DEST_IP_RANGE,...]] [--direction=DIRECTION] - [--[no-]disabled] [--layer4-configs=[LAYER4_CONFIG,...]] + --global-firewall-policy --layer4-configs=[LAYER4_CONFIG,...] + [--description=DESCRIPTION] [--dest-ip-ranges=[DEST_IP_RANGE,...]] + [--direction=DIRECTION] [--[no-]disabled] [--security-profile-group=SECURITY_PROFILE_GROUP] [--src-ip-ranges=[SRC_IP_RANGE,...]] [--target-secure-tags=[TARGET_SECURE_TAGS,...]] [GCLOUD_WIDE_FLAG ...] @@ -39,6 +39,10 @@ REQUIRED FLAGS --global-firewall-policy Use this flag to indicate that firewall policy is global. + --layer4-configs=[LAYER4_CONFIG,...] + A list of destination protocols and ports to which the firewall rule + will apply. + OPTIONAL FLAGS --description=DESCRIPTION An optional, textual description for the rule. @@ -54,10 +58,6 @@ OPTIONAL FLAGS Use this flag to disable the rule. Disabled rules will not affect traffic. Use --disabled to enable and --no-disabled to disable. - --layer4-configs=[LAYER4_CONFIG,...] - A list of destination protocols and ports to which the firewall rule - will apply. - --security-profile-group=SECURITY_PROFILE_GROUP A security profile group to be used with mirror action. diff --git a/gcloud/compute/network-firewall-policies/rules/create b/gcloud/compute/network-firewall-policies/rules/create index c64f3b1d0..67612a041 100644 --- a/gcloud/compute/network-firewall-policies/rules/create +++ b/gcloud/compute/network-firewall-policies/rules/create @@ -5,13 +5,12 @@ NAME SYNOPSIS gcloud compute network-firewall-policies rules create PRIORITY --action=ACTION --firewall-policy=FIREWALL_POLICY - [--description=DESCRIPTION] + --layer4-configs=[LAYER4_CONFIG,...] [--description=DESCRIPTION] [--dest-address-groups=[DEST_ADDRESS_GROUPS,...]] [--dest-fqdns=[DEST_FQDNS,...]] [--dest-ip-ranges=[DEST_IP_RANGE,...]] [--dest-region-codes=[DEST_REGION_CODES,...]] [--dest-threat-intelligence=[DEST_THREAT_INTELLIGENCE_LISTS,...]] [--direction=DIRECTION] [--[no-]disabled] [--[no-]enable-logging] - [--layer4-configs=[LAYER4_CONFIG,...]] [--security-profile-group=SECURITY_PROFILE_GROUP] [--src-address-groups=[SOURCE_ADDRESS_GROUPS,...]] [--src-fqdns=[SOURCE_FQDNS,...]] [--src-ip-ranges=[SRC_IP_RANGE,...]] @@ -56,6 +55,10 @@ REQUIRED FLAGS --firewall-policy=FIREWALL_POLICY Firewall policy ID with which to create rule. + --layer4-configs=[LAYER4_CONFIG,...] + A list of destination protocols and ports to which the firewall rule + will apply. + OPTIONAL FLAGS --description=DESCRIPTION An optional, textual description for the rule. @@ -94,10 +97,6 @@ OPTIONAL FLAGS by this rule. Use --enable-logging to enable and --no-enable-logging to disable. - --layer4-configs=[LAYER4_CONFIG,...] - A list of destination protocols and ports to which the firewall rule - will apply. - --security-profile-group=SECURITY_PROFILE_GROUP A security profile group to be used with apply_security_profile_group action. diff --git a/gcloud/compute/routes/create b/gcloud/compute/routes/create index 76ec8a6d3..2fdb2a565 100644 --- a/gcloud/compute/routes/create +++ b/gcloud/compute/routes/create @@ -25,13 +25,11 @@ DESCRIPTION Routes match packets by destination IP address, preferring smaller or more specific ranges over larger ones (see --destination-range). If there is a - tie, the system selects the route with the smallest priority value. If - there is still a tie, it uses the layer 3 and 4 packet headers to select - just one of the remaining matching routes. The packet is then forwarded as - specified by --next-hop-address, --next-hop-instance, - --next-hop-vpn-tunnel, or --next-hop-gateway of the winning route. Packets - that do not match any route in the sending virtual machine routing table - will be dropped. + tie, the system selects the route with the smallest priority value. The + packet is then forwarded as specified by --next-hop-address, + --next-hop-instance, --next-hop-vpn-tunnel, or --next-hop-gateway of the + winning route. Packets that do not match any route in the sending virtual + machine routing table will be dropped. Exactly one of --next-hop-address, --next-hop-gateway, --next-hop-vpn-tunnel, or --next-hop-instance must be provided with this diff --git a/gcloud/container/ai/help b/gcloud/container/ai/help new file mode 100644 index 000000000..6ccc19b02 --- /dev/null +++ b/gcloud/container/ai/help @@ -0,0 +1,25 @@ +NAME + gcloud container ai - manage AI related workloads for GKE + +SYNOPSIS + gcloud container ai GROUP [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage AI related workloads for GKE. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + profiles + Quickstart engine for GKE AI workloads. + +NOTES + This variant is also available: + + $ gcloud alpha container ai + diff --git a/gcloud/container/ai/profiles/benchmarks/help b/gcloud/container/ai/profiles/benchmarks/help new file mode 100644 index 000000000..fc2b6497f --- /dev/null +++ b/gcloud/container/ai/profiles/benchmarks/help @@ -0,0 +1,20 @@ +NAME + gcloud container ai profiles benchmarks - manage benchmarks for GKE + Inference Quickstart + +SYNOPSIS + gcloud container ai profiles benchmarks COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage benchmarks for GKE Inference Quickstart. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + list + List supported model servers for a given model. diff --git a/gcloud/ml-engine/models/list b/gcloud/container/ai/profiles/benchmarks/list similarity index 68% rename from gcloud/ml-engine/models/list rename to gcloud/container/ai/profiles/benchmarks/list index 10295409d..1f234ee86 100644 --- a/gcloud/ml-engine/models/list +++ b/gcloud/container/ai/profiles/benchmarks/list @@ -1,27 +1,37 @@ NAME - gcloud ml-engine models list - list existing AI Platform models + gcloud container ai profiles benchmarks list - list supported model servers + for a given model SYNOPSIS - gcloud ml-engine models list [--region=REGION] [--filter=EXPRESSION] + gcloud container ai profiles benchmarks list --model=MODEL + --model-server=MODEL_SERVER [--format=FORMAT] + [--instance-type=INSTANCE_TYPE] + [--model-server-version=MODEL_SERVER_VERSION] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - List existing AI Platform models. + To get supported models, run gcloud container ai profiles models list. + +REQUIRED FLAGS + --model=MODEL + The model. + + --model-server=MODEL_SERVER + The model server. FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. + --format=FORMAT + The format to print the output in. Default is csvprofile, which + displays the profile information in a CSV format, includingcost + conversions. - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints + --instance-type=INSTANCE_TYPE + The instance type. If not specified, this defaults to anyinstance type. - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. + --model-server-version=MODEL_SERVER_VERSION + The model server version. If not specified, this defaults to latest + model server version. LIST COMMAND FLAGS --filter=EXPRESSION @@ -62,11 +72,3 @@ GCLOUD WIDE FLAGS --trace-token, --user-output-enabled, --verbosity. Run $ gcloud help for details. - -NOTES - These variants are also available: - - $ gcloud alpha ml-engine models list - - $ gcloud beta ml-engine models list - diff --git a/gcloud/container/ai/profiles/help b/gcloud/container/ai/profiles/help new file mode 100644 index 000000000..496f414a5 --- /dev/null +++ b/gcloud/container/ai/profiles/help @@ -0,0 +1,51 @@ +NAME + gcloud container ai profiles - quickstart engine for GKE AI workloads + +SYNOPSIS + gcloud container ai profiles GROUP | COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + The GKE Inference Quickstart helps simplify deploying AI inference on + Google Kubernetes Engine (GKE). It provides tailored profiles based on + Google's internal benchmarks. Provide inputs like your preferred + open-source model (e.g. Llama, Gemma, or Mistral) and your application's + performance target. Based on these inputs, the quickstart generates + accelerator choices with performance metrics, and detailed, ready-to-deploy + profiles for compute, load balancing, and autoscaling. These profiles are + provided as standard Kubernetes YAML manifests, which you can deploy or + modify. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + benchmarks + Manage benchmarks for GKE Inference Quickstart. + + manifests + Generate optimized Kubernetes manifests. + + model-server-versions + Manage supported model server versions for GKE Inference Quickstart. + + model-servers + Manage supported model servers for GKE Inference Quickstart. + + models + Manage supported models for GKE Inference Quickstart. + +COMMANDS + COMMAND is one of the following: + + list + List compatible accelerator profiles. + +NOTES + This variant is also available: + + $ gcloud alpha container ai profiles + diff --git a/gcloud/container/ai/profiles/list b/gcloud/container/ai/profiles/list new file mode 100644 index 000000000..af050ec92 --- /dev/null +++ b/gcloud/container/ai/profiles/list @@ -0,0 +1,110 @@ +NAME + gcloud container ai profiles list - list compatible accelerator profiles + +SYNOPSIS + gcloud container ai profiles list [--format=FORMAT] [--model=MODEL] + [--model-server=MODEL_SERVER] + [--model-server-version=MODEL_SERVER_VERSION] + [--pricing-model=PRICING_MODEL] + [--target-cost-per-million-input-tokens=TARGET_COST_PER_MILLION_INPUT_TOKENS] + [--target-cost-per-million-output-tokens=TARGET_COST_PER_MILLION_OUTPUT_TOKENS] + [--target-ntpot-milliseconds=TARGET_NTPOT_MILLISECONDS] + [--target-ttft-milliseconds=TARGET_TTFT_MILLISECONDS] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + This command lists all supported accelerators with their performance + details. By default, the supported accelerators are displayed in a table + format with select information for each accelerator. To see all details, + use --format=yaml. + + To get supported model, model servers, and model server versions, run + gcloud container ai profiles models list, gcloud container ai profiles + model-servers list, and gcloud container ai profiles model-server-versions + list. + +FLAGS + --format=FORMAT + The output format. Default is profile, which displays the profile + information in a table format, including cost conversions. csvprofile + displays the profile information in a CSV format.Options include + csvprofile, profile, and yaml. + + --model=MODEL + The model. + + --model-server=MODEL_SERVER + The model server. If not specified, this defaults to any model server. + + --model-server-version=MODEL_SERVER_VERSION + The model server version. If not specified, this defaults to the latest + version. + + --pricing-model=PRICING_MODEL + The pricing model to use to calculate token cost. Currently, this + supports on-demand, spot, 3-years-cud, 1-year-cud + + --target-cost-per-million-input-tokens=TARGET_COST_PER_MILLION_INPUT_TOKENS + The target cost per million input tokens to filter profiles by, unit is + 1 USD up to 5 decimal places. + + --target-cost-per-million-output-tokens=TARGET_COST_PER_MILLION_OUTPUT_TOKENS + The target cost per million output tokens to filter profiles by, unit + is 1 USD up to 5 decimal places. + + --target-ntpot-milliseconds=TARGET_NTPOT_MILLISECONDS + The target normalized time per output token (NTPOT) in milliseconds. + NTPOT is measured as the request_latency / output_tokens. If this field + is set, the command will only return accelerators that can meet the + target ntpot milliseconds and display their throughput performance at + the target latency. Otherwise, the command will return all accelerators + and display their highest throughput performance. + + --target-ttft-milliseconds=TARGET_TTFT_MILLISECONDS + The target time to first token (TTFT) in milliseconds. TTFT is measured + as the request_latency / output_tokens. If this field is set, the + command will only return profiles that can meet the target ttft + milliseconds and display their throughput performance at the target + latency. Otherwise, the command will return all profiles and display + their highest throughput performance. + +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. diff --git a/gcloud/container/ai/profiles/manifests/create b/gcloud/container/ai/profiles/manifests/create new file mode 100644 index 000000000..d8f88d289 --- /dev/null +++ b/gcloud/container/ai/profiles/manifests/create @@ -0,0 +1,81 @@ +NAME + gcloud container ai profiles manifests create - generate ready-to-deploy + Kubernetes manifests with compute, load balancing, and autoscaling + capabilities + +SYNOPSIS + gcloud container ai profiles manifests create + --accelerator-type=ACCELERATOR_TYPE --model=MODEL + --model-server=MODEL_SERVER [--model-bucket-uri=MODEL_BUCKET_URI] + [--model-server-version=MODEL_SERVER_VERSION] [--namespace=NAMESPACE] + [--output=OUTPUT; default="all"] [--output-path=OUTPUT_PATH] + [--target-ntpot-milliseconds=TARGET_NTPOT_MILLISECONDS] + [--target-ttft-milliseconds=TARGET_TTFT_MILLISECONDS] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + To get supported model, model servers, and model server versions, run + gcloud alpha container ai profiles model-and-server-combinations list. To + get supported accelerators with their performance metrics, run gcloud alpha + container ai profiles accelerators list. + +REQUIRED FLAGS + --accelerator-type=ACCELERATOR_TYPE + The accelerator type. + + --model=MODEL + The model. + + --model-server=MODEL_SERVER + The model server. + +OPTIONAL FLAGS + --model-bucket-uri=MODEL_BUCKET_URI + The Google Cloud Storage bucket URI to load the model from. This URI + must point to the directory containing the model's config file + (config.json) and model weights. If unspecified, defaults to loading + the model from Hugging Face. + + --model-server-version=MODEL_SERVER_VERSION + The model server version. If not specified, this defaults to the latest + version. + + --namespace=NAMESPACE + The namespace to deploy the manifests in. Default namespace is + 'default'. + + --output=OUTPUT; default="all" + The output to display. Default is all. OUTPUT must be one of: manifest, + comments, all. + + --output-path=OUTPUT_PATH + The path to save the output to. If not specified, output to the + terminal. + + --target-ntpot-milliseconds=TARGET_NTPOT_MILLISECONDS + The maximum normalized time per output token (NTPOT) in milliseconds. + NTPOT is measured as the request_latency / output_tokens. If this is + set, the manifests will include Horizontal Pod Autoscaler (HPA) + resources which automatically adjust the model server replica count in + response to changes in model server load to keep p50 NTPOT below the + specified threshold. If the provided target-ntpot-milliseconds is too + low to achieve, the HPA manifest will not be generated. + + --target-ttft-milliseconds=TARGET_TTFT_MILLISECONDS + If specified, results will only show accelerators that can meet the + latency target and will show their throughput performances at the + target ttft target to achieve, the HPA manifest will not be generated. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --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 variant is also available: + + $ gcloud alpha container ai profiles manifests create + diff --git a/gcloud/container/ai/profiles/manifests/help b/gcloud/container/ai/profiles/manifests/help new file mode 100644 index 000000000..2510f2420 --- /dev/null +++ b/gcloud/container/ai/profiles/manifests/help @@ -0,0 +1,27 @@ +NAME + gcloud container ai profiles manifests - generate optimized Kubernetes + manifests + +SYNOPSIS + gcloud container ai profiles manifests COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Generate optimized Kubernetes manifests. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + Generate ready-to-deploy Kubernetes manifests with compute, load + balancing, and autoscaling capabilities. + +NOTES + This variant is also available: + + $ gcloud alpha container ai profiles manifests + diff --git a/gcloud/container/ai/profiles/model-server-versions/help b/gcloud/container/ai/profiles/model-server-versions/help new file mode 100644 index 000000000..05406a8e8 --- /dev/null +++ b/gcloud/container/ai/profiles/model-server-versions/help @@ -0,0 +1,27 @@ +NAME + gcloud container ai profiles model-server-versions - manage supported model + server versions for GKE Inference Quickstart + +SYNOPSIS + gcloud container ai profiles model-server-versions COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage supported model server versions for GKE Inference Quickstart. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + list + List supported model server versions. + +NOTES + This variant is also available: + + $ gcloud alpha container ai profiles model-server-versions + diff --git a/gcloud/alpha/ml-engine/jobs/list b/gcloud/container/ai/profiles/model-server-versions/list similarity index 75% rename from gcloud/alpha/ml-engine/jobs/list rename to gcloud/container/ai/profiles/model-server-versions/list index 0185fb1d5..a3a747b9a 100644 --- a/gcloud/alpha/ml-engine/jobs/list +++ b/gcloud/container/ai/profiles/model-server-versions/list @@ -1,18 +1,23 @@ NAME - gcloud alpha ml-engine jobs list - list existing AI Platform jobs + gcloud container ai profiles model-server-versions list - list supported + model server versions SYNOPSIS - gcloud alpha ml-engine jobs list [--filter=EXPRESSION] [--limit=LIMIT] + gcloud container ai profiles model-server-versions list --model=MODEL + --model-server=MODEL_SERVER [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) List existing AI Platform jobs. + To get supported model and model servers, run gcloud container ai profiles + models list and gcloud container ai profiles model-servers list. -EXAMPLES - To list the existing AI Platform jobs, run: +REQUIRED FLAGS + --model=MODEL + The model. - $ gcloud alpha ml-engine jobs list + --model-server=MODEL_SERVER + The model server. If not specified, this defaults to any model server. LIST COMMAND FLAGS --filter=EXPRESSION @@ -55,12 +60,7 @@ GCLOUD WIDE FLAGS 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: + This variant is also available: - $ gcloud ml-engine jobs list - - $ gcloud beta ml-engine jobs list + $ gcloud alpha container ai profiles model-server-versions list diff --git a/gcloud/container/ai/profiles/model-servers/help b/gcloud/container/ai/profiles/model-servers/help new file mode 100644 index 000000000..b3808a2f7 --- /dev/null +++ b/gcloud/container/ai/profiles/model-servers/help @@ -0,0 +1,26 @@ +NAME + gcloud container ai profiles model-servers - manage supported model servers + for GKE Inference Quickstart + +SYNOPSIS + gcloud container ai profiles model-servers COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage supported model servers for GKE Inference Quickstart. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + list + List supported model servers for a given model. + +NOTES + This variant is also available: + + $ gcloud alpha container ai profiles model-servers + diff --git a/gcloud/beta/ml-engine/jobs/list b/gcloud/container/ai/profiles/model-servers/list similarity index 77% rename from gcloud/beta/ml-engine/jobs/list rename to gcloud/container/ai/profiles/model-servers/list index a0f8825ed..d2c3d7752 100644 --- a/gcloud/beta/ml-engine/jobs/list +++ b/gcloud/container/ai/profiles/model-servers/list @@ -1,18 +1,18 @@ NAME - gcloud beta ml-engine jobs list - list existing AI Platform jobs + gcloud container ai profiles model-servers list - list supported model + servers for a given model SYNOPSIS - gcloud beta ml-engine jobs list [--filter=EXPRESSION] [--limit=LIMIT] - [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] - [GCLOUD_WIDE_FLAG ...] + gcloud container ai profiles model-servers list --model=MODEL + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) List existing AI Platform jobs. + To get supported models, run gcloud container ai profiles models list. -EXAMPLES - To list the existing AI Platform jobs, run: - - $ gcloud beta ml-engine jobs list +REQUIRED FLAGS + --model=MODEL + The model. LIST COMMAND FLAGS --filter=EXPRESSION @@ -55,10 +55,7 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. These - variants are also available: + This variant is also available: - $ gcloud ml-engine jobs list - - $ gcloud alpha ml-engine jobs list + $ gcloud alpha container ai profiles model-servers list diff --git a/gcloud/container/ai/profiles/models/help b/gcloud/container/ai/profiles/models/help new file mode 100644 index 000000000..959780a5f --- /dev/null +++ b/gcloud/container/ai/profiles/models/help @@ -0,0 +1,26 @@ +NAME + gcloud container ai profiles models - manage supported models for GKE + Inference Quickstart + +SYNOPSIS + gcloud container ai profiles models COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage supported models for GKE Inference Quickstart. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + list + List supported models. + +NOTES + This variant is also available: + + $ gcloud alpha container ai profiles models + diff --git a/gcloud/ml-engine/jobs/list b/gcloud/container/ai/profiles/models/list similarity index 81% rename from gcloud/ml-engine/jobs/list rename to gcloud/container/ai/profiles/models/list index 8627c4f79..27a622420 100644 --- a/gcloud/ml-engine/jobs/list +++ b/gcloud/container/ai/profiles/models/list @@ -1,18 +1,13 @@ NAME - gcloud ml-engine jobs list - list existing AI Platform jobs + gcloud container ai profiles models list - list supported models SYNOPSIS - gcloud ml-engine jobs list [--filter=EXPRESSION] [--limit=LIMIT] - [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + gcloud container ai profiles models list [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - List existing AI Platform jobs. - -EXAMPLES - To list the existing AI Platform jobs, run: - - $ gcloud ml-engine jobs list + List supported models. LIST COMMAND FLAGS --filter=EXPRESSION @@ -55,9 +50,7 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - These variants are also available: + This variant is also available: - $ gcloud alpha ml-engine jobs list - - $ gcloud beta ml-engine jobs list + $ gcloud alpha container ai profiles models list diff --git a/gcloud/container/fleet/help b/gcloud/container/fleet/help index 9a3de19fe..377962a08 100644 --- a/gcloud/container/fleet/help +++ b/gcloud/container/fleet/help @@ -79,6 +79,9 @@ GROUPS operations Manage Anthos fleet long-running operations. + packages + Manage Fleet Packages resources. + policycontroller Manage Policy Controller Feature. diff --git a/gcloud/container/fleet/packages/create b/gcloud/container/fleet/packages/create new file mode 100644 index 000000000..360ec31ba --- /dev/null +++ b/gcloud/container/fleet/packages/create @@ -0,0 +1,44 @@ +NAME + gcloud container fleet packages create - create Package Rollouts Fleet + Package + +SYNOPSIS + gcloud container fleet packages create NAME --source=SOURCE + [--location=LOCATION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create Package Rollouts Fleet Package. + +EXAMPLES + To create Fleet Package cert-manager-app, run: + + $ gcloud container fleet packages create cert-manager-app \ + --source=source.yaml + +POSITIONAL ARGUMENTS + NAME + Resource name. + +REQUIRED FLAGS + --source=SOURCE + Source file containing Fleet Package configuration. + +OPTIONAL FLAGS + --location=LOCATION + Google Cloud zone or region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container fleet packages create + + $ gcloud beta container fleet packages create + diff --git a/gcloud/container/fleet/packages/delete b/gcloud/container/fleet/packages/delete new file mode 100644 index 000000000..e6ad42665 --- /dev/null +++ b/gcloud/container/fleet/packages/delete @@ -0,0 +1,69 @@ +NAME + gcloud container fleet packages delete - delete Package Rollouts Fleet + Package + +SYNOPSIS + gcloud container fleet packages delete + (FLEET_PACKAGE : --location=LOCATION) [--force] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete Package Rollouts Fleet Package. + +EXAMPLES + To delete Fleet Package cert-manager-app in us-central1, run: + + $ gcloud container fleet packages delete cert-manager-app \ + --location=us-central1 + +POSITIONAL ARGUMENTS + Fleet package resource - The Fleet Package to create. The arguments in + this group can be used to specify the attributes of this resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. + + To set the project attribute: + ◆ provide the argument fleet_package on the command line with a fully + specified name; + ◆ set the property core/project. + + This must be specified. + + FLEET_PACKAGE + ID of the fleet-package or fully qualified identifier for the + fleet-package. + + To set the fleet-package attribute: + ▸ provide the argument fleet_package on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud zone or region for the fleet-package. + + To set the location attribute: + ▸ provide the argument fleet_package on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property config_delivery/location. + +FLAGS + --force + If true, force deletion of any child resources. Otherwise, attempting + to delete a Fleet Package with children will fail. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --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 container fleet packages delete + + $ gcloud beta container fleet packages delete + diff --git a/gcloud/container/fleet/packages/describe b/gcloud/container/fleet/packages/describe new file mode 100644 index 000000000..5e33c6a5e --- /dev/null +++ b/gcloud/container/fleet/packages/describe @@ -0,0 +1,69 @@ +NAME + gcloud container fleet packages describe - describe Package Rollouts Fleet + Package + +SYNOPSIS + gcloud container fleet packages describe + (FLEET_PACKAGE : --location=LOCATION) [--show-cluster-status] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe Package Rollouts Fleet Package. + +EXAMPLES + To view Fleet Package cert-manager-app in us-central1, run: + + $ gcloud container fleet packages describe cert-manager-app \ + --location=us-central1 + +POSITIONAL ARGUMENTS + Fleet package resource - The Fleet Package to describe. The arguments in + this group can be used to specify the attributes of this resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. + + To set the project attribute: + ◆ provide the argument fleet_package on the command line with a fully + specified name; + ◆ set the property core/project. + + This must be specified. + + FLEET_PACKAGE + ID of the fleet-package or fully qualified identifier for the + fleet-package. + + To set the fleet-package attribute: + ▸ provide the argument fleet_package on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud zone or region for the fleet-package. + + To set the location attribute: + ▸ provide the argument fleet_package on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property config_delivery/location. + +FLAGS + --show-cluster-status + Show more information about the Fleet Package. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container fleet packages describe + + $ gcloud beta container fleet packages describe + diff --git a/gcloud/container/fleet/packages/help b/gcloud/container/fleet/packages/help new file mode 100644 index 000000000..c64557e2a --- /dev/null +++ b/gcloud/container/fleet/packages/help @@ -0,0 +1,48 @@ +NAME + gcloud container fleet packages - manage Fleet Packages resources + +SYNOPSIS + gcloud container fleet packages GROUP | COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Fleet Packages resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + resource-bundles + Commands for managing Package Rollouts Resource Bundles. + + rollouts + Commands for managing Rollouts. + +COMMANDS + COMMAND is one of the following: + + create + Create Package Rollouts Fleet Package. + + delete + Delete Package Rollouts Fleet Package. + + describe + Describe Package Rollouts Fleet Package. + + list + List Package Rollouts Fleet Packages. + + update + Update Package Rollouts Fleet Package. + +NOTES + These variants are also available: + + $ gcloud alpha container fleet packages + + $ gcloud beta container fleet packages + diff --git a/gcloud/alpha/ml-engine/locations/list b/gcloud/container/fleet/packages/list similarity index 74% rename from gcloud/alpha/ml-engine/locations/list rename to gcloud/container/fleet/packages/list index 4850f6cbc..1c1a448c2 100644 --- a/gcloud/alpha/ml-engine/locations/list +++ b/gcloud/container/fleet/packages/list @@ -1,13 +1,22 @@ NAME - gcloud alpha ml-engine locations list - list AI Platform Locations + gcloud container fleet packages list - list Package Rollouts Fleet Packages SYNOPSIS - gcloud alpha ml-engine locations list [--filter=EXPRESSION] [--limit=LIMIT] - [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] - [GCLOUD_WIDE_FLAG ...] + gcloud container fleet packages list [--location=LOCATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) List AI Platform Locations. + List Package Rollouts Fleet Packages. + +EXAMPLES + To list all Fleet Packages in us-central1, run: + + $ gcloud container fleet packages list --location=us-central1 + +FLAGS + --location=LOCATION + Google Cloud zone or region. LIST COMMAND FLAGS --filter=EXPRESSION @@ -49,13 +58,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. -API REFERENCE - This command uses the ml/v1 API. The full documentation for this API can be - found at: https://cloud.google.com/ml/ - NOTES - This command is currently in alpha and might change without notice. If this - command fails 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 alpha container fleet packages list + + $ gcloud beta container fleet packages list diff --git a/gcloud/container/fleet/packages/resource-bundles/create b/gcloud/container/fleet/packages/resource-bundles/create new file mode 100644 index 000000000..b7494c1d7 --- /dev/null +++ b/gcloud/container/fleet/packages/resource-bundles/create @@ -0,0 +1,44 @@ +NAME + gcloud container fleet packages resource-bundles create - create Package + Rollouts Resource Bundle + +SYNOPSIS + gcloud container fleet packages resource-bundles create NAME + [--description=DESCRIPTION] [--location=LOCATION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create Package Rollouts Resource Bundle. + +EXAMPLES + To create Resource Bundle cert-manager in us-central1, run: + + $ gcloud container fleet packages resource-bundles create \ + cert-manager --location=us-central1 + +POSITIONAL ARGUMENTS + NAME + Resource name. + +FLAGS + --description=DESCRIPTION + Resource description. + + --location=LOCATION + Google Cloud zone or region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container fleet packages resource-bundles create + + $ gcloud beta container fleet packages resource-bundles create + diff --git a/gcloud/container/fleet/packages/resource-bundles/delete b/gcloud/container/fleet/packages/resource-bundles/delete new file mode 100644 index 000000000..337377d37 --- /dev/null +++ b/gcloud/container/fleet/packages/resource-bundles/delete @@ -0,0 +1,44 @@ +NAME + gcloud container fleet packages resource-bundles delete - delete Package + Rollouts Resource Bundle + +SYNOPSIS + gcloud container fleet packages resource-bundles delete NAME [--force] + [--location=LOCATION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete Package Rollouts Resource Bundle. + +EXAMPLES + To delete Resource Bundle cert-manager in us-central1, run: + + $ gcloud container fleet packages resource-bundles delete \ + cert-manager --location=us-central1 + +POSITIONAL ARGUMENTS + NAME + Resource name. + +FLAGS + --force + If true, force deletion of any child resources. Otherwise, attempting + to delete a Resource Bundle with children will fail. + + --location=LOCATION + Google Cloud zone or region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container fleet packages resource-bundles delete + + $ gcloud beta container fleet packages resource-bundles delete + diff --git a/gcloud/container/fleet/packages/resource-bundles/describe b/gcloud/container/fleet/packages/resource-bundles/describe new file mode 100644 index 000000000..32762f0d6 --- /dev/null +++ b/gcloud/container/fleet/packages/resource-bundles/describe @@ -0,0 +1,40 @@ +NAME + gcloud container fleet packages resource-bundles describe - describe + Package Rollouts Resource Bundle + +SYNOPSIS + gcloud container fleet packages resource-bundles describe NAME + [--location=LOCATION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe Package Rollouts Resource Bundle. + +EXAMPLES + To describe Resource Bundle cert-manager in us-central1, run: + + $ gcloud container fleet packages resource-bundles describe \ + cert-manager --location=us-central1 + +POSITIONAL ARGUMENTS + NAME + Resource name. + +FLAGS + --location=LOCATION + Google Cloud zone or region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container fleet packages resource-bundles describe + + $ gcloud beta container fleet packages resource-bundles describe + diff --git a/gcloud/container/fleet/packages/resource-bundles/help b/gcloud/container/fleet/packages/resource-bundles/help new file mode 100644 index 000000000..62db4af02 --- /dev/null +++ b/gcloud/container/fleet/packages/resource-bundles/help @@ -0,0 +1,47 @@ +NAME + gcloud container fleet packages resource-bundles - commands for managing + Package Rollouts Resource Bundles + +SYNOPSIS + gcloud container fleet packages resource-bundles GROUP | COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + See gcloud container fleet packages resource-bundles --help for help. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + releases + Commands for managing Package Rollouts Releases. + +COMMANDS + COMMAND is one of the following: + + create + Create Package Rollouts Resource Bundle. + + delete + Delete Package Rollouts Resource Bundle. + + describe + Describe Package Rollouts Resource Bundle. + + list + List Package Rollouts Resource Bundles. + + update + Update Package Rollouts Resource Bundle. + +NOTES + These variants are also available: + + $ gcloud alpha container fleet packages resource-bundles + + $ gcloud beta container fleet packages resource-bundles + diff --git a/gcloud/container/fleet/packages/resource-bundles/list b/gcloud/container/fleet/packages/resource-bundles/list new file mode 100644 index 000000000..330aa22fc --- /dev/null +++ b/gcloud/container/fleet/packages/resource-bundles/list @@ -0,0 +1,69 @@ +NAME + gcloud container fleet packages resource-bundles list - list Package + Rollouts Resource Bundles + +SYNOPSIS + gcloud container fleet packages resource-bundles list [--location=LOCATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List Package Rollouts Resource Bundles. + +EXAMPLES + To list Resource Bundles in us-central1, run: + + $ gcloud container fleet packages resource-bundles list \ + --location=us-central1 + +FLAGS + --location=LOCATION + Google Cloud zone or region. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container fleet packages resource-bundles list + + $ gcloud beta container fleet packages resource-bundles list + diff --git a/gcloud/container/fleet/packages/resource-bundles/releases/create b/gcloud/container/fleet/packages/resource-bundles/releases/create new file mode 100644 index 000000000..ccdc4305d --- /dev/null +++ b/gcloud/container/fleet/packages/resource-bundles/releases/create @@ -0,0 +1,76 @@ +NAME + gcloud container fleet packages resource-bundles releases create - create + Package Rollouts Release + +SYNOPSIS + gcloud container fleet packages resource-bundles releases create + --resource-bundle=RESOURCE_BUNDLE --source=SOURCE --version=VERSION + [--lifecycle=LIFECYCLE] [--location=LOCATION] + [--variants-pattern=VARIANTS_PATTERN; default="*"] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create Package Rollouts Release. + +EXAMPLES + To create Release v1.0.0 for Resource Bundle my-bundle in us-central1, run: + + $ gcloud container fleet packages resource-bundles releases create \ + --version=v1.0.0 --resource-bundle=my-bundle \ + --source=manifest.yaml + + To create a Release with multiple variants in one directory, run: + + $ gcloud container fleet packages resource-bundles releases create \ + --version=v1.0.0 --resource-bundle=my-bundle \ + --source=/manifests/ --variants-pattern=manifest-*.yaml + + To create a Release with multiple variants across multiple directories, ex: + + $ gcloud container fleet packages resource-bundles releases create \ + --version=v1.0.0 --resource-bundle=my-bundle \ + --source=/manifests/ --variants-pattern=dir-*/ + +REQUIRED FLAGS + --resource-bundle=RESOURCE_BUNDLE + Resource Bundle name. + + --source=SOURCE + Source file or directory to create the Release from. e.g. + --source=manifest.yaml, --source=/manifests-dir/ Can optionally be + paired with the --variants-pattern arg to create multiple variants of a + Release. + + --version=VERSION + Version of the Release to create. + +OPTIONAL FLAGS + --lifecycle=LIFECYCLE + Lifecycle of the Release. + + --location=LOCATION + Google Cloud zone or region. + + --variants-pattern=VARIANTS_PATTERN; default="*" + Glob pattern to Variants of the Release, to be paired with the --source + arg. ex: --source=/manifests-dir/ --variants-pattern=**, + --source=/manifests-dir/ --variants-pattern=us-*.yaml, + --source=/manifests/dir/ --variants-pattern=*/*.yaml + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container fleet packages resource-bundles releases \ + create + + $ gcloud beta container fleet packages resource-bundles releases \ + create + diff --git a/gcloud/container/fleet/packages/resource-bundles/releases/delete b/gcloud/container/fleet/packages/resource-bundles/releases/delete new file mode 100644 index 000000000..b746779fd --- /dev/null +++ b/gcloud/container/fleet/packages/resource-bundles/releases/delete @@ -0,0 +1,51 @@ +NAME + gcloud container fleet packages resource-bundles releases delete - delete + Package Rollouts Release + +SYNOPSIS + gcloud container fleet packages resource-bundles releases delete RELEASE + --resource-bundle=RESOURCE_BUNDLE [--force] [--location=LOCATION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete Package Rollouts Release. + +EXAMPLES + To delete Release v1.0.0 of cert-manager in us-central1, run: + + $ gcloud container fleet packages resource-bundles releases delete \ + v1.0.0 --location=us-central1 --resource-bundle=cert-manager + +POSITIONAL ARGUMENTS + RELEASE + Release identifier, either a version or tag. + +REQUIRED FLAGS + --resource-bundle=RESOURCE_BUNDLE + Resource Bundle name. + +OPTIONAL FLAGS + --force + If true, force deletion of any child resources. Otherwise, attempting + to delete a Release with children will fail. + + --location=LOCATION + Google Cloud zone or region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container fleet packages resource-bundles releases \ + delete + + $ gcloud beta container fleet packages resource-bundles releases \ + delete + diff --git a/gcloud/container/fleet/packages/resource-bundles/releases/describe b/gcloud/container/fleet/packages/resource-bundles/releases/describe new file mode 100644 index 000000000..916f4adea --- /dev/null +++ b/gcloud/container/fleet/packages/resource-bundles/releases/describe @@ -0,0 +1,48 @@ +NAME + gcloud container fleet packages resource-bundles releases describe - + describe Package Rollouts Release + +SYNOPSIS + gcloud container fleet packages resource-bundles releases describe RELEASE + --resource-bundle=RESOURCE_BUNDLE [--location=LOCATION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe Package Rollouts Release. + +EXAMPLES + To view release v1.0.0 of cert-manager in us-central1, run: + + $ gcloud container fleet packages resource-bundles releases \ + describe v1.0.0 --location=us-central1 \ + --resource-bundle=cert-manager + +POSITIONAL ARGUMENTS + RELEASE + Release identifier, either a version or tag. + +REQUIRED FLAGS + --resource-bundle=RESOURCE_BUNDLE + Resource Bundle name. + +OPTIONAL FLAGS + --location=LOCATION + Google Cloud zone or region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container fleet packages resource-bundles releases \ + describe + + $ gcloud beta container fleet packages resource-bundles releases \ + describe + diff --git a/gcloud/container/fleet/packages/resource-bundles/releases/help b/gcloud/container/fleet/packages/resource-bundles/releases/help new file mode 100644 index 000000000..2c018c87f --- /dev/null +++ b/gcloud/container/fleet/packages/resource-bundles/releases/help @@ -0,0 +1,42 @@ +NAME + gcloud container fleet packages resource-bundles releases - commands for + managing Package Rollouts Releases + +SYNOPSIS + gcloud container fleet packages resource-bundles releases COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + See gcloud container fleet packages resource-bundles releases --help for + help. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + Create Package Rollouts Release. + + delete + Delete Package Rollouts Release. + + describe + Describe Package Rollouts Release. + + list + List Releases of a Resource Bundle. + + update + Update Package Rollouts Release. + +NOTES + These variants are also available: + + $ gcloud alpha container fleet packages resource-bundles releases + + $ gcloud beta container fleet packages resource-bundles releases + diff --git a/gcloud/ml-engine/versions/list b/gcloud/container/fleet/packages/resource-bundles/releases/list similarity index 70% rename from gcloud/ml-engine/versions/list rename to gcloud/container/fleet/packages/resource-bundles/releases/list index 8f0c70c8d..7308b238d 100644 --- a/gcloud/ml-engine/versions/list +++ b/gcloud/container/fleet/packages/resource-bundles/releases/list @@ -1,31 +1,29 @@ NAME - gcloud ml-engine versions list - list existing AI Platform versions + gcloud container fleet packages resource-bundles releases list - list + Releases of a Resource Bundle SYNOPSIS - gcloud ml-engine versions list --model=MODEL [--region=REGION] + gcloud container fleet packages resource-bundles releases list + --resource-bundle=RESOURCE_BUNDLE [--location=LOCATION] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - List existing AI Platform versions. + List Releases of a Resource Bundle. + +EXAMPLES + To list all Releases for bundle cert-manager in us-central1, run: + + $ gcloud container fleet packages resource-bundles releases list \ + --resource-bundle=cert-manager --location=us-central1 REQUIRED FLAGS - --model=MODEL - Name of the model. + --resource-bundle=RESOURCE_BUNDLE + Resource Bundle name. FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. + --location=LOCATION + Google Cloud zone or region. LIST COMMAND FLAGS --filter=EXPRESSION @@ -70,7 +68,8 @@ GCLOUD WIDE FLAGS NOTES These variants are also available: - $ gcloud alpha ml-engine versions list + $ gcloud alpha container fleet packages resource-bundles releases \ + list - $ gcloud beta ml-engine versions list + $ gcloud beta container fleet packages resource-bundles releases list diff --git a/gcloud/container/fleet/packages/resource-bundles/releases/update b/gcloud/container/fleet/packages/resource-bundles/releases/update new file mode 100644 index 000000000..b0caef434 --- /dev/null +++ b/gcloud/container/fleet/packages/resource-bundles/releases/update @@ -0,0 +1,51 @@ +NAME + gcloud container fleet packages resource-bundles releases update - update + Package Rollouts Release + +SYNOPSIS + gcloud container fleet packages resource-bundles releases update RELEASE + --resource-bundle=RESOURCE_BUNDLE [--lifecycle=LIFECYCLE] + [--location=LOCATION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update Package Rollouts Release. + +EXAMPLES + To update Release v1.0.0 for Resource Bundle my-bundle in us-central1, run: + + $ gcloud container fleet packages resource-bundles releases update \ + --version=v1.0.0 --resource-bundle=my-bundle \ + --lifecycle=PUBLISHED + +POSITIONAL ARGUMENTS + RELEASE + Release identifier, either a version or tag. + +REQUIRED FLAGS + --resource-bundle=RESOURCE_BUNDLE + Resource Bundle name. + +OPTIONAL FLAGS + --lifecycle=LIFECYCLE + Lifecycle of the Release. + + --location=LOCATION + Google Cloud zone or region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --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 container fleet packages resource-bundles releases \ + update + + $ gcloud beta container fleet packages resource-bundles releases \ + update + diff --git a/gcloud/container/fleet/packages/resource-bundles/update b/gcloud/container/fleet/packages/resource-bundles/update new file mode 100644 index 000000000..9637eeb93 --- /dev/null +++ b/gcloud/container/fleet/packages/resource-bundles/update @@ -0,0 +1,44 @@ +NAME + gcloud container fleet packages resource-bundles update - update Package + Rollouts Resource Bundle + +SYNOPSIS + gcloud container fleet packages resource-bundles update NAME + [--description=DESCRIPTION] [--location=LOCATION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update Package Rollouts Resource Bundle. + +EXAMPLES + To update Resource Bundle cert-manager in us-central1, run: + + $ gcloud container fleet packages resource-bundles update \ + cert-manager --location=us-central1 ... + +POSITIONAL ARGUMENTS + NAME + Resource name. + +FLAGS + --description=DESCRIPTION + Resource description. + + --location=LOCATION + Google Cloud zone or region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container fleet packages resource-bundles update + + $ gcloud beta container fleet packages resource-bundles update + diff --git a/gcloud/container/fleet/packages/rollouts/abort b/gcloud/container/fleet/packages/rollouts/abort new file mode 100644 index 000000000..53598633d --- /dev/null +++ b/gcloud/container/fleet/packages/rollouts/abort @@ -0,0 +1,74 @@ +NAME + gcloud container fleet packages rollouts abort - abort Rollout resource + +SYNOPSIS + gcloud container fleet packages rollouts abort + (ROLLOUT : --fleet-package=FLEET_PACKAGE --location=LOCATION) + [--reason=REASON] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Abort Rollout resource. + +EXAMPLES + To abort Rollout 20240318 for cert-manager-app in us-central1, run: + + $ gcloud container fleet packages rollouts abort 20240318 \ + --fleet-package=cert-manager-app --location=us-central1 + +POSITIONAL ARGUMENTS + Rollout resource - The rollout to abort. The arguments in this group can + be used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument rollout on the command line with a fully + specified name; + ◆ set the property core/project. + + This must be specified. + + ROLLOUT + ID of the rollout or fully qualified identifier for the rollout. + + To set the rollout attribute: + ▸ provide the argument rollout on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --fleet-package=FLEET_PACKAGE + Fleet Package name. + + To set the fleet-package attribute: + ▸ provide the argument rollout on the command line with a fully + specified name; + ▸ provide the argument --fleet-package on the command line. + + --location=LOCATION + Google Cloud zone or region for the rollout. + + To set the location attribute: + ▸ provide the argument rollout on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property config_delivery/location. + +FLAGS + --reason=REASON + Reason for aborting rollout. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container fleet packages rollouts abort + + $ gcloud beta container fleet packages rollouts abort + diff --git a/gcloud/container/fleet/packages/rollouts/describe b/gcloud/container/fleet/packages/rollouts/describe new file mode 100644 index 000000000..0e265957d --- /dev/null +++ b/gcloud/container/fleet/packages/rollouts/describe @@ -0,0 +1,48 @@ +NAME + gcloud container fleet packages rollouts describe - describe Rollout + resource + +SYNOPSIS + gcloud container fleet packages rollouts describe NAME + --fleet-package=FLEET_PACKAGE [--less] [--location=LOCATION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe Rollout resource. + +EXAMPLES + To view Rollout 20240318 for cert-manager-app in us-central1, run: + + $ gcloud container fleet packages rollouts describe 20240318 \ + --fleet-package=cert-manager-app --location=us-central1 + +POSITIONAL ARGUMENTS + NAME + Resource name. + +REQUIRED FLAGS + --fleet-package=FLEET_PACKAGE + Parent Fleet Package of the Rollout. + +OPTIONAL FLAGS + --less + Show less verbose output. + + --location=LOCATION + Google Cloud zone or region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container fleet packages rollouts describe + + $ gcloud beta container fleet packages rollouts describe + diff --git a/gcloud/container/fleet/packages/rollouts/help b/gcloud/container/fleet/packages/rollouts/help new file mode 100644 index 000000000..530dda6e4 --- /dev/null +++ b/gcloud/container/fleet/packages/rollouts/help @@ -0,0 +1,39 @@ +NAME + gcloud container fleet packages rollouts - commands for managing Rollouts + +SYNOPSIS + gcloud container fleet packages rollouts COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + See gcloud container fleet packages rollouts --help for help. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + abort + Abort Rollout resource. + + describe + Describe Rollout resource. + + list + List Rollouts of a Fleet Package. + + resume + Resume suspended Rollout. + + suspend + Suspend in-progress Rollout. + +NOTES + These variants are also available: + + $ gcloud alpha container fleet packages rollouts + + $ gcloud beta container fleet packages rollouts + diff --git a/gcloud/container/fleet/packages/rollouts/list b/gcloud/container/fleet/packages/rollouts/list new file mode 100644 index 000000000..1df9729ee --- /dev/null +++ b/gcloud/container/fleet/packages/rollouts/list @@ -0,0 +1,78 @@ +NAME + gcloud container fleet packages rollouts list - list Rollouts of a Fleet + Package + +SYNOPSIS + gcloud container fleet packages rollouts list --fleet-package=FLEET_PACKAGE + [--less] [--location=LOCATION] [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List Rollouts of a Fleet Package. + +EXAMPLES + To list all Rollouts for Fleet Package cert-manager-app in us-central1, + run: + + $ gcloud container fleet packages rollouts list \ + --fleet-package=cert-manager-app --location=us-central1 + +REQUIRED FLAGS + --fleet-package=FLEET_PACKAGE + Parent Fleet Package of the Rollout. + +FLAGS + --less + Show less verbose output. + + --location=LOCATION + Google Cloud zone or region. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container fleet packages rollouts list + + $ gcloud beta container fleet packages rollouts list + diff --git a/gcloud/container/fleet/packages/rollouts/resume b/gcloud/container/fleet/packages/rollouts/resume new file mode 100644 index 000000000..74f48e183 --- /dev/null +++ b/gcloud/container/fleet/packages/rollouts/resume @@ -0,0 +1,74 @@ +NAME + gcloud container fleet packages rollouts resume - resume suspended Rollout + +SYNOPSIS + gcloud container fleet packages rollouts resume + (ROLLOUT : --fleet-package=FLEET_PACKAGE --location=LOCATION) + [--reason=REASON] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Resume suspended Rollout. + +EXAMPLES + To resume Rollout 20240318 for cert-manager-app in us-central1, run: + + $ gcloud container fleet packages rollouts resume 20240318 \ + --fleet-package=cert-manager-app --location=us-central1 + +POSITIONAL ARGUMENTS + Rollout resource - The rollout to resume. The arguments in this group can + be used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument rollout on the command line with a fully + specified name; + ◆ set the property core/project. + + This must be specified. + + ROLLOUT + ID of the rollout or fully qualified identifier for the rollout. + + To set the rollout attribute: + ▸ provide the argument rollout on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --fleet-package=FLEET_PACKAGE + Fleet Package name. + + To set the fleet-package attribute: + ▸ provide the argument rollout on the command line with a fully + specified name; + ▸ provide the argument --fleet-package on the command line. + + --location=LOCATION + Google Cloud zone or region for the rollout. + + To set the location attribute: + ▸ provide the argument rollout on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property config_delivery/location. + +FLAGS + --reason=REASON + Reason for resuming rollout. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container fleet packages rollouts resume + + $ gcloud beta container fleet packages rollouts resume + diff --git a/gcloud/container/fleet/packages/rollouts/suspend b/gcloud/container/fleet/packages/rollouts/suspend new file mode 100644 index 000000000..a6b6739ea --- /dev/null +++ b/gcloud/container/fleet/packages/rollouts/suspend @@ -0,0 +1,75 @@ +NAME + gcloud container fleet packages rollouts suspend - suspend in-progress + Rollout + +SYNOPSIS + gcloud container fleet packages rollouts suspend + (ROLLOUT : --fleet-package=FLEET_PACKAGE --location=LOCATION) + [--reason=REASON] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Suspend in-progress Rollout. + +EXAMPLES + To suspend Rollout 20240318 for cert-manager-app in us-central1, run: + + $ gcloud container fleet packages rollouts suspend 20240318 \ + --fleet-package=cert-manager-app --location=us-central1 + +POSITIONAL ARGUMENTS + Rollout resource - The rollout to suspend. The arguments in this group can + be used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument rollout on the command line with a fully + specified name; + ◆ set the property core/project. + + This must be specified. + + ROLLOUT + ID of the rollout or fully qualified identifier for the rollout. + + To set the rollout attribute: + ▸ provide the argument rollout on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --fleet-package=FLEET_PACKAGE + Fleet Package name. + + To set the fleet-package attribute: + ▸ provide the argument rollout on the command line with a fully + specified name; + ▸ provide the argument --fleet-package on the command line. + + --location=LOCATION + Google Cloud zone or region for the rollout. + + To set the location attribute: + ▸ provide the argument rollout on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property config_delivery/location. + +FLAGS + --reason=REASON + Reason for suspending rollout. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container fleet packages rollouts suspend + + $ gcloud beta container fleet packages rollouts suspend + diff --git a/gcloud/container/fleet/packages/update b/gcloud/container/fleet/packages/update new file mode 100644 index 000000000..4424efa81 --- /dev/null +++ b/gcloud/container/fleet/packages/update @@ -0,0 +1,69 @@ +NAME + gcloud container fleet packages update - update Package Rollouts Fleet + Package + +SYNOPSIS + gcloud container fleet packages update + (FLEET_PACKAGE : --location=LOCATION) --source=SOURCE + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update Package Rollouts Fleet Package. + +EXAMPLES + To update Fleet Package cert-manager-app, run: + + $ gcloud container fleet packages update cert-manager-app \ + --source=my_source.yaml + +POSITIONAL ARGUMENTS + Fleet package resource - The Fleet Package to create. The arguments in + this group can be used to specify the attributes of this resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. + + To set the project attribute: + ◆ provide the argument fleet_package on the command line with a fully + specified name; + ◆ set the property core/project. + + This must be specified. + + FLEET_PACKAGE + ID of the fleet-package or fully qualified identifier for the + fleet-package. + + To set the fleet-package attribute: + ▸ provide the argument fleet_package on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud zone or region for the fleet-package. + + To set the location attribute: + ▸ provide the argument fleet_package on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property config_delivery/location. + +REQUIRED FLAGS + --source=SOURCE + Source file containing Fleet Package configuration. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container fleet packages update + + $ gcloud beta container fleet packages update + diff --git a/gcloud/container/help b/gcloud/container/help index d40486248..241517f41 100644 --- a/gcloud/container/help +++ b/gcloud/container/help @@ -26,6 +26,9 @@ GCLOUD WIDE FLAGS GROUPS GROUP is one of the following: + ai + Manage AI related workloads for GKE. + attached Manage Attached clusters for running containers. diff --git a/gcloud/container/hub/help b/gcloud/container/hub/help index 6ebb8060f..c01dcda48 100644 --- a/gcloud/container/hub/help +++ b/gcloud/container/hub/help @@ -79,6 +79,9 @@ GROUPS operations Manage Anthos fleet long-running operations. + packages + Manage Fleet Packages resources. + policycontroller Manage Policy Controller Feature. diff --git a/gcloud/container/hub/packages/create b/gcloud/container/hub/packages/create new file mode 100644 index 000000000..9a00e242f --- /dev/null +++ b/gcloud/container/hub/packages/create @@ -0,0 +1,44 @@ +NAME + gcloud container hub packages create - create Package Rollouts Fleet + Package + +SYNOPSIS + gcloud container hub packages create NAME --source=SOURCE + [--location=LOCATION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create Package Rollouts Fleet Package. + +EXAMPLES + To create Fleet Package cert-manager-app, run: + + $ gcloud container hub packages create cert-manager-app \ + --source=source.yaml + +POSITIONAL ARGUMENTS + NAME + Resource name. + +REQUIRED FLAGS + --source=SOURCE + Source file containing Fleet Package configuration. + +OPTIONAL FLAGS + --location=LOCATION + Google Cloud zone or region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container hub packages create + + $ gcloud beta container hub packages create + diff --git a/gcloud/container/hub/packages/delete b/gcloud/container/hub/packages/delete new file mode 100644 index 000000000..ea6087ca9 --- /dev/null +++ b/gcloud/container/hub/packages/delete @@ -0,0 +1,69 @@ +NAME + gcloud container hub packages delete - delete Package Rollouts Fleet + Package + +SYNOPSIS + gcloud container hub packages delete (FLEET_PACKAGE : --location=LOCATION) + [--force] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete Package Rollouts Fleet Package. + +EXAMPLES + To delete Fleet Package cert-manager-app in us-central1, run: + + $ gcloud container hub packages delete cert-manager-app \ + --location=us-central1 + +POSITIONAL ARGUMENTS + Fleet package resource - The Fleet Package to create. The arguments in + this group can be used to specify the attributes of this resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. + + To set the project attribute: + ◆ provide the argument fleet_package on the command line with a fully + specified name; + ◆ set the property core/project. + + This must be specified. + + FLEET_PACKAGE + ID of the fleet-package or fully qualified identifier for the + fleet-package. + + To set the fleet-package attribute: + ▸ provide the argument fleet_package on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud zone or region for the fleet-package. + + To set the location attribute: + ▸ provide the argument fleet_package on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property config_delivery/location. + +FLAGS + --force + If true, force deletion of any child resources. Otherwise, attempting + to delete a Fleet Package with children will fail. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --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 container hub packages delete + + $ gcloud beta container hub packages delete + diff --git a/gcloud/container/hub/packages/describe b/gcloud/container/hub/packages/describe new file mode 100644 index 000000000..72d973cbc --- /dev/null +++ b/gcloud/container/hub/packages/describe @@ -0,0 +1,69 @@ +NAME + gcloud container hub packages describe - describe Package Rollouts Fleet + Package + +SYNOPSIS + gcloud container hub packages describe + (FLEET_PACKAGE : --location=LOCATION) [--show-cluster-status] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe Package Rollouts Fleet Package. + +EXAMPLES + To view Fleet Package cert-manager-app in us-central1, run: + + $ gcloud container hub packages describe cert-manager-app \ + --location=us-central1 + +POSITIONAL ARGUMENTS + Fleet package resource - The Fleet Package to describe. The arguments in + this group can be used to specify the attributes of this resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. + + To set the project attribute: + ◆ provide the argument fleet_package on the command line with a fully + specified name; + ◆ set the property core/project. + + This must be specified. + + FLEET_PACKAGE + ID of the fleet-package or fully qualified identifier for the + fleet-package. + + To set the fleet-package attribute: + ▸ provide the argument fleet_package on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud zone or region for the fleet-package. + + To set the location attribute: + ▸ provide the argument fleet_package on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property config_delivery/location. + +FLAGS + --show-cluster-status + Show more information about the Fleet Package. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container hub packages describe + + $ gcloud beta container hub packages describe + diff --git a/gcloud/container/hub/packages/help b/gcloud/container/hub/packages/help new file mode 100644 index 000000000..3f4b64dc7 --- /dev/null +++ b/gcloud/container/hub/packages/help @@ -0,0 +1,48 @@ +NAME + gcloud container hub packages - manage Fleet Packages resources + +SYNOPSIS + gcloud container hub packages GROUP | COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Fleet Packages resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + resource-bundles + Commands for managing Package Rollouts Resource Bundles. + + rollouts + Commands for managing Rollouts. + +COMMANDS + COMMAND is one of the following: + + create + Create Package Rollouts Fleet Package. + + delete + Delete Package Rollouts Fleet Package. + + describe + Describe Package Rollouts Fleet Package. + + list + List Package Rollouts Fleet Packages. + + update + Update Package Rollouts Fleet Package. + +NOTES + These variants are also available: + + $ gcloud alpha container hub packages + + $ gcloud beta container hub packages + diff --git a/gcloud/container/hub/packages/list b/gcloud/container/hub/packages/list new file mode 100644 index 000000000..7cf8659df --- /dev/null +++ b/gcloud/container/hub/packages/list @@ -0,0 +1,67 @@ +NAME + gcloud container hub packages list - list Package Rollouts Fleet Packages + +SYNOPSIS + gcloud container hub packages list [--location=LOCATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List Package Rollouts Fleet Packages. + +EXAMPLES + To list all Fleet Packages in us-central1, run: + + $ gcloud container hub packages list --location=us-central1 + +FLAGS + --location=LOCATION + Google Cloud zone or region. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container hub packages list + + $ gcloud beta container hub packages list + diff --git a/gcloud/container/hub/packages/resource-bundles/create b/gcloud/container/hub/packages/resource-bundles/create new file mode 100644 index 000000000..63fd30396 --- /dev/null +++ b/gcloud/container/hub/packages/resource-bundles/create @@ -0,0 +1,44 @@ +NAME + gcloud container hub packages resource-bundles create - create Package + Rollouts Resource Bundle + +SYNOPSIS + gcloud container hub packages resource-bundles create NAME + [--description=DESCRIPTION] [--location=LOCATION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create Package Rollouts Resource Bundle. + +EXAMPLES + To create Resource Bundle cert-manager in us-central1, run: + + $ gcloud container hub packages resource-bundles create \ + cert-manager --location=us-central1 + +POSITIONAL ARGUMENTS + NAME + Resource name. + +FLAGS + --description=DESCRIPTION + Resource description. + + --location=LOCATION + Google Cloud zone or region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container hub packages resource-bundles create + + $ gcloud beta container hub packages resource-bundles create + diff --git a/gcloud/container/hub/packages/resource-bundles/delete b/gcloud/container/hub/packages/resource-bundles/delete new file mode 100644 index 000000000..3f4461176 --- /dev/null +++ b/gcloud/container/hub/packages/resource-bundles/delete @@ -0,0 +1,44 @@ +NAME + gcloud container hub packages resource-bundles delete - delete Package + Rollouts Resource Bundle + +SYNOPSIS + gcloud container hub packages resource-bundles delete NAME [--force] + [--location=LOCATION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete Package Rollouts Resource Bundle. + +EXAMPLES + To delete Resource Bundle cert-manager in us-central1, run: + + $ gcloud container hub packages resource-bundles delete \ + cert-manager --location=us-central1 + +POSITIONAL ARGUMENTS + NAME + Resource name. + +FLAGS + --force + If true, force deletion of any child resources. Otherwise, attempting + to delete a Resource Bundle with children will fail. + + --location=LOCATION + Google Cloud zone or region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container hub packages resource-bundles delete + + $ gcloud beta container hub packages resource-bundles delete + diff --git a/gcloud/container/hub/packages/resource-bundles/describe b/gcloud/container/hub/packages/resource-bundles/describe new file mode 100644 index 000000000..d0454ce92 --- /dev/null +++ b/gcloud/container/hub/packages/resource-bundles/describe @@ -0,0 +1,40 @@ +NAME + gcloud container hub packages resource-bundles describe - describe Package + Rollouts Resource Bundle + +SYNOPSIS + gcloud container hub packages resource-bundles describe NAME + [--location=LOCATION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe Package Rollouts Resource Bundle. + +EXAMPLES + To describe Resource Bundle cert-manager in us-central1, run: + + $ gcloud container hub packages resource-bundles describe \ + cert-manager --location=us-central1 + +POSITIONAL ARGUMENTS + NAME + Resource name. + +FLAGS + --location=LOCATION + Google Cloud zone or region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container hub packages resource-bundles describe + + $ gcloud beta container hub packages resource-bundles describe + diff --git a/gcloud/container/hub/packages/resource-bundles/help b/gcloud/container/hub/packages/resource-bundles/help new file mode 100644 index 000000000..f040286aa --- /dev/null +++ b/gcloud/container/hub/packages/resource-bundles/help @@ -0,0 +1,47 @@ +NAME + gcloud container hub packages resource-bundles - commands for managing + Package Rollouts Resource Bundles + +SYNOPSIS + gcloud container hub packages resource-bundles GROUP | COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + See gcloud container fleet packages resource-bundles --help for help. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + releases + Commands for managing Package Rollouts Releases. + +COMMANDS + COMMAND is one of the following: + + create + Create Package Rollouts Resource Bundle. + + delete + Delete Package Rollouts Resource Bundle. + + describe + Describe Package Rollouts Resource Bundle. + + list + List Package Rollouts Resource Bundles. + + update + Update Package Rollouts Resource Bundle. + +NOTES + These variants are also available: + + $ gcloud alpha container hub packages resource-bundles + + $ gcloud beta container hub packages resource-bundles + diff --git a/gcloud/container/hub/packages/resource-bundles/list b/gcloud/container/hub/packages/resource-bundles/list new file mode 100644 index 000000000..ab54976ce --- /dev/null +++ b/gcloud/container/hub/packages/resource-bundles/list @@ -0,0 +1,69 @@ +NAME + gcloud container hub packages resource-bundles list - list Package Rollouts + Resource Bundles + +SYNOPSIS + gcloud container hub packages resource-bundles list [--location=LOCATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List Package Rollouts Resource Bundles. + +EXAMPLES + To list Resource Bundles in us-central1, run: + + $ gcloud container hub packages resource-bundles list \ + --location=us-central1 + +FLAGS + --location=LOCATION + Google Cloud zone or region. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container hub packages resource-bundles list + + $ gcloud beta container hub packages resource-bundles list + diff --git a/gcloud/container/hub/packages/resource-bundles/releases/create b/gcloud/container/hub/packages/resource-bundles/releases/create new file mode 100644 index 000000000..414702c6d --- /dev/null +++ b/gcloud/container/hub/packages/resource-bundles/releases/create @@ -0,0 +1,75 @@ +NAME + gcloud container hub packages resource-bundles releases create - create + Package Rollouts Release + +SYNOPSIS + gcloud container hub packages resource-bundles releases create + --resource-bundle=RESOURCE_BUNDLE --source=SOURCE --version=VERSION + [--lifecycle=LIFECYCLE] [--location=LOCATION] + [--variants-pattern=VARIANTS_PATTERN; default="*"] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create Package Rollouts Release. + +EXAMPLES + To create Release v1.0.0 for Resource Bundle my-bundle in us-central1, run: + + $ gcloud container hub packages resource-bundles releases create \ + --version=v1.0.0 --resource-bundle=my-bundle \ + --source=manifest.yaml + + To create a Release with multiple variants in one directory, run: + + $ gcloud container hub packages resource-bundles releases create \ + --version=v1.0.0 --resource-bundle=my-bundle \ + --source=/manifests/ --variants-pattern=manifest-*.yaml + + To create a Release with multiple variants across multiple directories, ex: + + $ gcloud container hub packages resource-bundles releases create \ + --version=v1.0.0 --resource-bundle=my-bundle \ + --source=/manifests/ --variants-pattern=dir-*/ + +REQUIRED FLAGS + --resource-bundle=RESOURCE_BUNDLE + Resource Bundle name. + + --source=SOURCE + Source file or directory to create the Release from. e.g. + --source=manifest.yaml, --source=/manifests-dir/ Can optionally be + paired with the --variants-pattern arg to create multiple variants of a + Release. + + --version=VERSION + Version of the Release to create. + +OPTIONAL FLAGS + --lifecycle=LIFECYCLE + Lifecycle of the Release. + + --location=LOCATION + Google Cloud zone or region. + + --variants-pattern=VARIANTS_PATTERN; default="*" + Glob pattern to Variants of the Release, to be paired with the --source + arg. ex: --source=/manifests-dir/ --variants-pattern=**, + --source=/manifests-dir/ --variants-pattern=us-*.yaml, + --source=/manifests/dir/ --variants-pattern=*/*.yaml + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container hub packages resource-bundles releases \ + create + + $ gcloud beta container hub packages resource-bundles releases create + diff --git a/gcloud/container/hub/packages/resource-bundles/releases/delete b/gcloud/container/hub/packages/resource-bundles/releases/delete new file mode 100644 index 000000000..92dd4964a --- /dev/null +++ b/gcloud/container/hub/packages/resource-bundles/releases/delete @@ -0,0 +1,50 @@ +NAME + gcloud container hub packages resource-bundles releases delete - delete + Package Rollouts Release + +SYNOPSIS + gcloud container hub packages resource-bundles releases delete RELEASE + --resource-bundle=RESOURCE_BUNDLE [--force] [--location=LOCATION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete Package Rollouts Release. + +EXAMPLES + To delete Release v1.0.0 of cert-manager in us-central1, run: + + $ gcloud container hub packages resource-bundles releases delete \ + v1.0.0 --location=us-central1 --resource-bundle=cert-manager + +POSITIONAL ARGUMENTS + RELEASE + Release identifier, either a version or tag. + +REQUIRED FLAGS + --resource-bundle=RESOURCE_BUNDLE + Resource Bundle name. + +OPTIONAL FLAGS + --force + If true, force deletion of any child resources. Otherwise, attempting + to delete a Release with children will fail. + + --location=LOCATION + Google Cloud zone or region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container hub packages resource-bundles releases \ + delete + + $ gcloud beta container hub packages resource-bundles releases delete + diff --git a/gcloud/container/hub/packages/resource-bundles/releases/describe b/gcloud/container/hub/packages/resource-bundles/releases/describe new file mode 100644 index 000000000..a44437d71 --- /dev/null +++ b/gcloud/container/hub/packages/resource-bundles/releases/describe @@ -0,0 +1,47 @@ +NAME + gcloud container hub packages resource-bundles releases describe - describe + Package Rollouts Release + +SYNOPSIS + gcloud container hub packages resource-bundles releases describe RELEASE + --resource-bundle=RESOURCE_BUNDLE [--location=LOCATION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe Package Rollouts Release. + +EXAMPLES + To view release v1.0.0 of cert-manager in us-central1, run: + + $ gcloud container hub packages resource-bundles releases describe \ + v1.0.0 --location=us-central1 --resource-bundle=cert-manager + +POSITIONAL ARGUMENTS + RELEASE + Release identifier, either a version or tag. + +REQUIRED FLAGS + --resource-bundle=RESOURCE_BUNDLE + Resource Bundle name. + +OPTIONAL FLAGS + --location=LOCATION + Google Cloud zone or region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container hub packages resource-bundles releases \ + describe + + $ gcloud beta container hub packages resource-bundles releases \ + describe + diff --git a/gcloud/container/hub/packages/resource-bundles/releases/help b/gcloud/container/hub/packages/resource-bundles/releases/help new file mode 100644 index 000000000..b9ceaa023 --- /dev/null +++ b/gcloud/container/hub/packages/resource-bundles/releases/help @@ -0,0 +1,42 @@ +NAME + gcloud container hub packages resource-bundles releases - commands for + managing Package Rollouts Releases + +SYNOPSIS + gcloud container hub packages resource-bundles releases COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + See gcloud container fleet packages resource-bundles releases --help for + help. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + Create Package Rollouts Release. + + delete + Delete Package Rollouts Release. + + describe + Describe Package Rollouts Release. + + list + List Releases of a Resource Bundle. + + update + Update Package Rollouts Release. + +NOTES + These variants are also available: + + $ gcloud alpha container hub packages resource-bundles releases + + $ gcloud beta container hub packages resource-bundles releases + diff --git a/gcloud/beta/ml-engine/operations/list b/gcloud/container/hub/packages/resource-bundles/releases/list similarity index 67% rename from gcloud/beta/ml-engine/operations/list rename to gcloud/container/hub/packages/resource-bundles/releases/list index 7b8398cff..bc0d02531 100644 --- a/gcloud/beta/ml-engine/operations/list +++ b/gcloud/container/hub/packages/resource-bundles/releases/list @@ -1,28 +1,29 @@ NAME - gcloud beta ml-engine operations list - list existing AI Platform jobs + gcloud container hub packages resource-bundles releases list - list + Releases of a Resource Bundle SYNOPSIS - gcloud beta ml-engine operations list [--region=REGION] + gcloud container hub packages resource-bundles releases list + --resource-bundle=RESOURCE_BUNDLE [--location=LOCATION] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) List existing AI Platform jobs. + List Releases of a Resource Bundle. + +EXAMPLES + To list all Releases for bundle cert-manager in us-central1, run: + + $ gcloud container hub packages resource-bundles releases list \ + --resource-bundle=cert-manager --location=us-central1 + +REQUIRED FLAGS + --resource-bundle=RESOURCE_BUNDLE + Resource Bundle name. FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - If unspecified, the command uses the global endpoint of the AI Platform - Training and Prediction API. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: asia-east1, asia-northeast1, asia-southeast1, - australia-southeast1, europe-west1, europe-west2, europe-west3, - europe-west4, northamerica-northeast1, us-central1, us-east1, us-east4, - us-west1. + --location=LOCATION + Google Cloud zone or region. LIST COMMAND FLAGS --filter=EXPRESSION @@ -65,10 +66,9 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. These - variants are also available: + These variants are also available: - $ gcloud ml-engine operations list + $ gcloud alpha container hub packages resource-bundles releases list - $ gcloud alpha ml-engine operations list + $ gcloud beta container hub packages resource-bundles releases list diff --git a/gcloud/container/hub/packages/resource-bundles/releases/update b/gcloud/container/hub/packages/resource-bundles/releases/update new file mode 100644 index 000000000..cbaab6baa --- /dev/null +++ b/gcloud/container/hub/packages/resource-bundles/releases/update @@ -0,0 +1,50 @@ +NAME + gcloud container hub packages resource-bundles releases update - update + Package Rollouts Release + +SYNOPSIS + gcloud container hub packages resource-bundles releases update RELEASE + --resource-bundle=RESOURCE_BUNDLE [--lifecycle=LIFECYCLE] + [--location=LOCATION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update Package Rollouts Release. + +EXAMPLES + To update Release v1.0.0 for Resource Bundle my-bundle in us-central1, run: + + $ gcloud container hub packages resource-bundles releases update \ + --version=v1.0.0 --resource-bundle=my-bundle \ + --lifecycle=PUBLISHED + +POSITIONAL ARGUMENTS + RELEASE + Release identifier, either a version or tag. + +REQUIRED FLAGS + --resource-bundle=RESOURCE_BUNDLE + Resource Bundle name. + +OPTIONAL FLAGS + --lifecycle=LIFECYCLE + Lifecycle of the Release. + + --location=LOCATION + Google Cloud zone or region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --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 container hub packages resource-bundles releases \ + update + + $ gcloud beta container hub packages resource-bundles releases update + diff --git a/gcloud/container/hub/packages/resource-bundles/update b/gcloud/container/hub/packages/resource-bundles/update new file mode 100644 index 000000000..13c31a805 --- /dev/null +++ b/gcloud/container/hub/packages/resource-bundles/update @@ -0,0 +1,44 @@ +NAME + gcloud container hub packages resource-bundles update - update Package + Rollouts Resource Bundle + +SYNOPSIS + gcloud container hub packages resource-bundles update NAME + [--description=DESCRIPTION] [--location=LOCATION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update Package Rollouts Resource Bundle. + +EXAMPLES + To update Resource Bundle cert-manager in us-central1, run: + + $ gcloud container hub packages resource-bundles update \ + cert-manager --location=us-central1 ... + +POSITIONAL ARGUMENTS + NAME + Resource name. + +FLAGS + --description=DESCRIPTION + Resource description. + + --location=LOCATION + Google Cloud zone or region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container hub packages resource-bundles update + + $ gcloud beta container hub packages resource-bundles update + diff --git a/gcloud/container/hub/packages/rollouts/abort b/gcloud/container/hub/packages/rollouts/abort new file mode 100644 index 000000000..06662c741 --- /dev/null +++ b/gcloud/container/hub/packages/rollouts/abort @@ -0,0 +1,74 @@ +NAME + gcloud container hub packages rollouts abort - abort Rollout resource + +SYNOPSIS + gcloud container hub packages rollouts abort + (ROLLOUT : --fleet-package=FLEET_PACKAGE --location=LOCATION) + [--reason=REASON] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Abort Rollout resource. + +EXAMPLES + To abort Rollout 20240318 for cert-manager-app in us-central1, run: + + $ gcloud container hub packages rollouts abort 20240318 \ + --fleet-package=cert-manager-app --location=us-central1 + +POSITIONAL ARGUMENTS + Rollout resource - The rollout to abort. The arguments in this group can + be used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument rollout on the command line with a fully + specified name; + ◆ set the property core/project. + + This must be specified. + + ROLLOUT + ID of the rollout or fully qualified identifier for the rollout. + + To set the rollout attribute: + ▸ provide the argument rollout on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --fleet-package=FLEET_PACKAGE + Fleet Package name. + + To set the fleet-package attribute: + ▸ provide the argument rollout on the command line with a fully + specified name; + ▸ provide the argument --fleet-package on the command line. + + --location=LOCATION + Google Cloud zone or region for the rollout. + + To set the location attribute: + ▸ provide the argument rollout on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property config_delivery/location. + +FLAGS + --reason=REASON + Reason for aborting rollout. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container hub packages rollouts abort + + $ gcloud beta container hub packages rollouts abort + diff --git a/gcloud/container/hub/packages/rollouts/describe b/gcloud/container/hub/packages/rollouts/describe new file mode 100644 index 000000000..98f46a7e3 --- /dev/null +++ b/gcloud/container/hub/packages/rollouts/describe @@ -0,0 +1,47 @@ +NAME + gcloud container hub packages rollouts describe - describe Rollout resource + +SYNOPSIS + gcloud container hub packages rollouts describe NAME + --fleet-package=FLEET_PACKAGE [--less] [--location=LOCATION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe Rollout resource. + +EXAMPLES + To view Rollout 20240318 for cert-manager-app in us-central1, run: + + $ gcloud container hub packages rollouts describe 20240318 \ + --fleet-package=cert-manager-app --location=us-central1 + +POSITIONAL ARGUMENTS + NAME + Resource name. + +REQUIRED FLAGS + --fleet-package=FLEET_PACKAGE + Parent Fleet Package of the Rollout. + +OPTIONAL FLAGS + --less + Show less verbose output. + + --location=LOCATION + Google Cloud zone or region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container hub packages rollouts describe + + $ gcloud beta container hub packages rollouts describe + diff --git a/gcloud/container/hub/packages/rollouts/help b/gcloud/container/hub/packages/rollouts/help new file mode 100644 index 000000000..04c6c3faa --- /dev/null +++ b/gcloud/container/hub/packages/rollouts/help @@ -0,0 +1,39 @@ +NAME + gcloud container hub packages rollouts - commands for managing Rollouts + +SYNOPSIS + gcloud container hub packages rollouts COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + See gcloud container fleet packages rollouts --help for help. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + abort + Abort Rollout resource. + + describe + Describe Rollout resource. + + list + List Rollouts of a Fleet Package. + + resume + Resume suspended Rollout. + + suspend + Suspend in-progress Rollout. + +NOTES + These variants are also available: + + $ gcloud alpha container hub packages rollouts + + $ gcloud beta container hub packages rollouts + diff --git a/gcloud/container/hub/packages/rollouts/list b/gcloud/container/hub/packages/rollouts/list new file mode 100644 index 000000000..708e0284a --- /dev/null +++ b/gcloud/container/hub/packages/rollouts/list @@ -0,0 +1,78 @@ +NAME + gcloud container hub packages rollouts list - list Rollouts of a Fleet + Package + +SYNOPSIS + gcloud container hub packages rollouts list --fleet-package=FLEET_PACKAGE + [--less] [--location=LOCATION] [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List Rollouts of a Fleet Package. + +EXAMPLES + To list all Rollouts for Fleet Package cert-manager-app in us-central1, + run: + + $ gcloud container hub packages rollouts list \ + --fleet-package=cert-manager-app --location=us-central1 + +REQUIRED FLAGS + --fleet-package=FLEET_PACKAGE + Parent Fleet Package of the Rollout. + +FLAGS + --less + Show less verbose output. + + --location=LOCATION + Google Cloud zone or region. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container hub packages rollouts list + + $ gcloud beta container hub packages rollouts list + diff --git a/gcloud/container/hub/packages/rollouts/resume b/gcloud/container/hub/packages/rollouts/resume new file mode 100644 index 000000000..c1d9ad229 --- /dev/null +++ b/gcloud/container/hub/packages/rollouts/resume @@ -0,0 +1,74 @@ +NAME + gcloud container hub packages rollouts resume - resume suspended Rollout + +SYNOPSIS + gcloud container hub packages rollouts resume + (ROLLOUT : --fleet-package=FLEET_PACKAGE --location=LOCATION) + [--reason=REASON] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Resume suspended Rollout. + +EXAMPLES + To resume Rollout 20240318 for cert-manager-app in us-central1, run: + + $ gcloud container hub packages rollouts resume 20240318 \ + --fleet-package=cert-manager-app --location=us-central1 + +POSITIONAL ARGUMENTS + Rollout resource - The rollout to resume. The arguments in this group can + be used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument rollout on the command line with a fully + specified name; + ◆ set the property core/project. + + This must be specified. + + ROLLOUT + ID of the rollout or fully qualified identifier for the rollout. + + To set the rollout attribute: + ▸ provide the argument rollout on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --fleet-package=FLEET_PACKAGE + Fleet Package name. + + To set the fleet-package attribute: + ▸ provide the argument rollout on the command line with a fully + specified name; + ▸ provide the argument --fleet-package on the command line. + + --location=LOCATION + Google Cloud zone or region for the rollout. + + To set the location attribute: + ▸ provide the argument rollout on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property config_delivery/location. + +FLAGS + --reason=REASON + Reason for resuming rollout. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container hub packages rollouts resume + + $ gcloud beta container hub packages rollouts resume + diff --git a/gcloud/container/hub/packages/rollouts/suspend b/gcloud/container/hub/packages/rollouts/suspend new file mode 100644 index 000000000..7bb3a8824 --- /dev/null +++ b/gcloud/container/hub/packages/rollouts/suspend @@ -0,0 +1,75 @@ +NAME + gcloud container hub packages rollouts suspend - suspend in-progress + Rollout + +SYNOPSIS + gcloud container hub packages rollouts suspend + (ROLLOUT : --fleet-package=FLEET_PACKAGE --location=LOCATION) + [--reason=REASON] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Suspend in-progress Rollout. + +EXAMPLES + To suspend Rollout 20240318 for cert-manager-app in us-central1, run: + + $ gcloud container hub packages rollouts suspend 20240318 \ + --fleet-package=cert-manager-app --location=us-central1 + +POSITIONAL ARGUMENTS + Rollout resource - The rollout to suspend. The arguments in this group can + be used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument rollout on the command line with a fully + specified name; + ◆ set the property core/project. + + This must be specified. + + ROLLOUT + ID of the rollout or fully qualified identifier for the rollout. + + To set the rollout attribute: + ▸ provide the argument rollout on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --fleet-package=FLEET_PACKAGE + Fleet Package name. + + To set the fleet-package attribute: + ▸ provide the argument rollout on the command line with a fully + specified name; + ▸ provide the argument --fleet-package on the command line. + + --location=LOCATION + Google Cloud zone or region for the rollout. + + To set the location attribute: + ▸ provide the argument rollout on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property config_delivery/location. + +FLAGS + --reason=REASON + Reason for suspending rollout. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container hub packages rollouts suspend + + $ gcloud beta container hub packages rollouts suspend + diff --git a/gcloud/container/hub/packages/update b/gcloud/container/hub/packages/update new file mode 100644 index 000000000..47d45b143 --- /dev/null +++ b/gcloud/container/hub/packages/update @@ -0,0 +1,68 @@ +NAME + gcloud container hub packages update - update Package Rollouts Fleet + Package + +SYNOPSIS + gcloud container hub packages update (FLEET_PACKAGE : --location=LOCATION) + --source=SOURCE [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update Package Rollouts Fleet Package. + +EXAMPLES + To update Fleet Package cert-manager-app, run: + + $ gcloud container hub packages update cert-manager-app \ + --source=my_source.yaml + +POSITIONAL ARGUMENTS + Fleet package resource - The Fleet Package to create. The arguments in + this group can be used to specify the attributes of this resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. + + To set the project attribute: + ◆ provide the argument fleet_package on the command line with a fully + specified name; + ◆ set the property core/project. + + This must be specified. + + FLEET_PACKAGE + ID of the fleet-package or fully qualified identifier for the + fleet-package. + + To set the fleet-package attribute: + ▸ provide the argument fleet_package on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud zone or region for the fleet-package. + + To set the location attribute: + ▸ provide the argument fleet_package on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property config_delivery/location. + +REQUIRED FLAGS + --source=SOURCE + Source file containing Fleet Package configuration. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container hub packages update + + $ gcloud beta container hub packages update + diff --git a/gcloud/dataflow/flex-template/build b/gcloud/dataflow/flex-template/build index 65fc4ea44..ef3967225 100644 --- a/gcloud/dataflow/flex-template/build +++ b/gcloud/dataflow/flex-template/build @@ -89,9 +89,11 @@ REQUIRED FLAGS --flex-template-base-image=FLEX_TEMPLATE_BASE_IMAGE Flex template base image to be used while building the container image. Allowed choices are allowed labels (JAVA11, JAVA17, JAVA21, - PYTHON3, GO), or full gcr.io path of the specific version of the base - image. For labels, we use the latest base image version to build the - container. You can also provide a specific version from this link + PYTHON3, GO), supported distroless images (JAVA11_DISTROLESS, + JAVA17_DISTROLESS, JAVA21_DISTROLESS, GO_DISTROLESS), or full gcr.io + path of the specific version of the base image. For labels, we use + the latest base image version to build the container. You can also + provide a specific version from this link https://gcr.io/dataflow-templates-base/ This flag argument must be specified if any of the other arguments in diff --git a/gcloud/dataplex/datascans/create/data-quality b/gcloud/dataplex/datascans/create/data-quality index d4c28d252..7c44a7771 100644 --- a/gcloud/dataplex/datascans/create/data-quality +++ b/gcloud/dataplex/datascans/create/data-quality @@ -65,9 +65,11 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --data-quality-spec-file=DATA_QUALITY_SPEC_FILE - path to the JSON/YAML file containing the spec for the data quality - scan. The json representation reference: + Path to the JSON/YAML file containing the spec for the data quality + scan. The JSON representation reference: https://cloud.google.com/dataplex/docs/reference/rest/v1/DataQualitySpec + The YAML representation reference: + https://cloud.google.com/dataplex/docs/use-auto-data-quality#create-scan-using-gcloud Data source for the data quality scan. diff --git a/gcloud/dataplex/datascans/update/data-quality b/gcloud/dataplex/datascans/update/data-quality index d5397fe5f..ae08d9840 100644 --- a/gcloud/dataplex/datascans/update/data-quality +++ b/gcloud/dataplex/datascans/update/data-quality @@ -58,9 +58,11 @@ POSITIONAL ARGUMENTS FLAGS --data-quality-spec-file=DATA_QUALITY_SPEC_FILE - path to the JSON/YAML file containing the spec for the data quality - scan. The json representation reference: + Path to the JSON/YAML file containing the spec for the data quality + scan. The JSON representation reference: https://cloud.google.com/dataplex/docs/reference/rest/v1/DataQualitySpec + The YAML representation reference: + https://cloud.google.com/dataplex/docs/use-auto-data-quality#create-scan-using-gcloud --description=DESCRIPTION Description of the data quality scan diff --git a/gcloud/managed-kafka/acls/list b/gcloud/managed-kafka/acls/list index c70142ddc..9e88d4ea0 100644 --- a/gcloud/managed-kafka/acls/list +++ b/gcloud/managed-kafka/acls/list @@ -4,8 +4,8 @@ NAME SYNOPSIS gcloud managed-kafka acls list (CLUSTER : --location=LOCATION) - [--filter=EXPRESSION] [--limit=LIMIT] [--sort-by=[FIELD,...]] - [GCLOUD_WIDE_FLAG ...] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION List all Managed Service for Apache Kafka acls in a given cluster. To @@ -64,6 +64,13 @@ LIST COMMAND FLAGS 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 diff --git a/gcloud/managed-kafka/clusters/update b/gcloud/managed-kafka/clusters/update index 280f3f5e0..79a0b1a0d 100644 --- a/gcloud/managed-kafka/clusters/update +++ b/gcloud/managed-kafka/clusters/update @@ -7,7 +7,8 @@ SYNOPSIS (--auto-rebalance --cpu=CPU --labels=[KEY=VALUE,...] --memory=MEMORY --ssl-principal-mapping-rules=SSL_PRINCIPAL_MAPPING_RULES --subnets=[SUBNETS,...] --clear-mtls-ca-pools - | --mtls-ca-pools=[MTLS_CA_POOLS,...]) [--async] + | --mtls-ca-pools=[MTLS_CA_POOLS,...]) + [--allow-broker-downscale-on-cluster-upscale] [--async] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -117,6 +118,13 @@ REQUIRED FLAGS CA pools using the --clear-mtls-ca-pools flag. OPTIONAL FLAGS + --allow-broker-downscale-on-cluster-upscale + If enabled, this setting allows an update operation that could + significantly decrease the per-broker vCPU and/or memory allocation, + which can lead to reduced performance and availability. By default, an + update operation will fail if it results in a reduction of 10% or more + to the brokers' vCPU or memory allocation. + --async Return immediately, without waiting for the operation in progress to complete. diff --git a/gcloud/ml-engine/help b/gcloud/ml-engine/help deleted file mode 100644 index 0d39ed4e4..000000000 --- a/gcloud/ml-engine/help +++ /dev/null @@ -1,55 +0,0 @@ -NAME - gcloud ml-engine - manage AI Platform jobs and models - -SYNOPSIS - gcloud ml-engine GROUP | COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - The gcloud ml-engine command group lets you manage AI Platform jobs and - training models. - - AI Platform is a managed service that enables you to easily build machine - learning models, that work on any type of data, of any size. Create your - model with the powerful TensorFlow framework that powers many Google - products, from Google Photos to Google Cloud Speech. - - More information on AI Platform can be found here: - https://cloud.google.com/ml and detailed documentation can be found here: - https://cloud.google.com/ml/docs/ - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -GROUPS - GROUP is one of the following: - - jobs - AI Platform Jobs commands. - - local - AI Platform Local commands. - - models - AI Platform Models commands. - - operations - Manage AI Platform operations. - - versions - AI Platform Versions commands. - -COMMANDS - COMMAND is one of the following: - - predict - Run AI Platform online prediction. - -NOTES - These variants are also available: - - $ gcloud alpha ml-engine - - $ gcloud beta ml-engine - diff --git a/gcloud/ml-engine/jobs/cancel b/gcloud/ml-engine/jobs/cancel deleted file mode 100644 index 29fb819bf..000000000 --- a/gcloud/ml-engine/jobs/cancel +++ /dev/null @@ -1,30 +0,0 @@ -NAME - gcloud ml-engine jobs cancel - cancel a running AI Platform job - -SYNOPSIS - gcloud ml-engine jobs cancel JOB [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - gcloud ml-engine jobs cancel cancels a running AI Platform job. If the job - is already finished, the command will not perform an operation and exit - successfully. - -POSITIONAL ARGUMENTS - JOB - Name of the job. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine jobs cancel - - $ gcloud beta ml-engine jobs cancel - diff --git a/gcloud/ml-engine/jobs/describe b/gcloud/ml-engine/jobs/describe deleted file mode 100644 index 5ab630a9e..000000000 --- a/gcloud/ml-engine/jobs/describe +++ /dev/null @@ -1,55 +0,0 @@ -NAME - gcloud ml-engine jobs describe - describe an AI Platform job - -SYNOPSIS - gcloud ml-engine jobs describe JOB [--summarize] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Describe an AI Platform job. - -EXAMPLES - To describe the AI Platform job named my-job, run: - - gcloud ml-engine jobs describe my-job - -POSITIONAL ARGUMENTS - JOB - Name of the job. - -FLAGS - --summarize - Summarize job output in a set of human readable tables instead of - rendering the entire resource as json or yaml. The tables currently - rendered are: - - ◆ Job Overview: Overview of job including, jobId, status and create - time. - ◆ Training Input Summary: Summary of input for a training job - including region, main training python module and scale tier. - ◆ Training Output Summary: Summary of output for a training job - including the amount of ML units consumed by the job. - ◆ Training Output Trials: Summary of hyperparameter trials run for a - hyperparameter tuning training job. - ◆ Predict Input Summary: Summary of input for a prediction job - including region, model verion and output path. - ◆ Predict Output Summary: Summary of output for a prediction job - including prediction count and output path. - - This flag overrides the --format flag. If both are present on the - command line, a warning is displayed. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine jobs describe - - $ gcloud beta ml-engine jobs describe - diff --git a/gcloud/ml-engine/jobs/help b/gcloud/ml-engine/jobs/help deleted file mode 100644 index d60264736..000000000 --- a/gcloud/ml-engine/jobs/help +++ /dev/null @@ -1,45 +0,0 @@ -NAME - gcloud ml-engine jobs - AI Platform Jobs commands - -SYNOPSIS - gcloud ml-engine jobs GROUP | COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - AI Platform Jobs commands. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -GROUPS - GROUP is one of the following: - - submit - AI Platform Jobs submit commands. - -COMMANDS - COMMAND is one of the following: - - cancel - Cancel a running AI Platform job. - - describe - Describe an AI Platform job. - - list - List existing AI Platform jobs. - - stream-logs - Show logs from a running AI Platform job. - - update - Update an AI Platform job. - -NOTES - These variants are also available: - - $ gcloud alpha ml-engine jobs - - $ gcloud beta ml-engine jobs - diff --git a/gcloud/ml-engine/jobs/stream-logs b/gcloud/ml-engine/jobs/stream-logs deleted file mode 100644 index b9bfba939..000000000 --- a/gcloud/ml-engine/jobs/stream-logs +++ /dev/null @@ -1,48 +0,0 @@ -NAME - gcloud ml-engine jobs stream-logs - show logs from a running AI Platform - job - -SYNOPSIS - gcloud ml-engine jobs stream-logs JOB [--allow-multiline-logs] - [--polling-interval=POLLING_INTERVAL; default=60] - [--task-name=TASK_NAME] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Show logs from a running AI Platform job. - -EXAMPLES - To show the logs from running the AI Platform job my-job, run: - - $ gcloud ml-engine jobs stream-logs my-job - -POSITIONAL ARGUMENTS - JOB - Name of the job. - -FLAGS - --allow-multiline-logs - Output multiline log messages as single records. - - --polling-interval=POLLING_INTERVAL; default=60 - Number of seconds to wait between efforts to fetch the latest log - messages. Overrides the default ml_engine/polling_interval property - value for this command invocation. - - --task-name=TASK_NAME - If set, display only the logs for this particular task. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine jobs stream-logs - - $ gcloud beta ml-engine jobs stream-logs - diff --git a/gcloud/ml-engine/jobs/submit/help b/gcloud/ml-engine/jobs/submit/help deleted file mode 100644 index e78a117a1..000000000 --- a/gcloud/ml-engine/jobs/submit/help +++ /dev/null @@ -1,30 +0,0 @@ -NAME - gcloud ml-engine jobs submit - AI Platform Jobs submit commands - -SYNOPSIS - gcloud ml-engine jobs submit COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - AI Platform Jobs submit commands. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -COMMANDS - COMMAND is one of the following: - - prediction - Start an AI Platform batch prediction job. - - training - Submit an AI Platform training job. - -NOTES - These variants are also available: - - $ gcloud alpha ml-engine jobs submit - - $ gcloud beta ml-engine jobs submit - diff --git a/gcloud/ml-engine/jobs/submit/prediction b/gcloud/ml-engine/jobs/submit/prediction deleted file mode 100644 index 4d48a00dd..000000000 --- a/gcloud/ml-engine/jobs/submit/prediction +++ /dev/null @@ -1,120 +0,0 @@ -NAME - gcloud ml-engine jobs submit prediction - start an AI Platform batch - prediction job - -SYNOPSIS - gcloud ml-engine jobs submit prediction JOB --data-format=DATA_FORMAT - --input-paths=INPUT_PATH,[INPUT_PATH,...] --output-path=OUTPUT_PATH - --region=REGION (--model=MODEL | --model-dir=MODEL_DIR) - [--batch-size=BATCH_SIZE] [--labels=[KEY=VALUE,...]] - [--max-worker-count=MAX_WORKER_COUNT] - [--runtime-version=RUNTIME_VERSION] [--signature-name=SIGNATURE_NAME] - [--version=VERSION] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Start an AI Platform batch prediction job. - -POSITIONAL ARGUMENTS - JOB - Name of the batch prediction job. - -REQUIRED FLAGS - --data-format=DATA_FORMAT - Data format of the input files. DATA_FORMAT must be one of: - - text - Text and JSON files; for text files, see - https://www.tensorflow.org/guide/datasets#consuming_text_data, for - JSON files, see - https://cloud.google.com/ai-platform/prediction/docs/overview#batch_prediction_input_data - tf-record - TFRecord files; see - https://www.tensorflow.org/guide/datasets#consuming_tfrecord_data - tf-record-gzip - GZIP-compressed TFRecord files. - - --input-paths=INPUT_PATH,[INPUT_PATH,...] - Cloud Storage paths to the instances to run prediction on. - - Wildcards (*) accepted at the end of a path. More than one path can be - specified if multiple file patterns are needed. For example, - - gs://my-bucket/instances*,gs://my-bucket/other-instances1 - - will match any objects whose names start with instances in my-bucket as - well as the other-instances1 bucket, while - - gs://my-bucket/instance-dir/* - - will match any objects in the instance-dir "directory" (since - directories aren't a first-class Cloud Storage concept) of my-bucket. - - --output-path=OUTPUT_PATH - Cloud Storage path to which to save the output. Example: - gs://my-bucket/output. - - --region=REGION - The Compute Engine region to run the job in. - - Exactly one of these must be specified: - - --model=MODEL - Name of the model to use for prediction. - - --model-dir=MODEL_DIR - Cloud Storage location where the model files are located. - -OPTIONAL FLAGS - --batch-size=BATCH_SIZE - The number of records per batch. The service will buffer batch_size - number of records in memory before invoking TensorFlow. Defaults to 64 - if not specified. - - --labels=[KEY=VALUE,...] - List of label KEY=VALUE pairs to add. - - Keys must start with a lowercase character and contain only hyphens - (-), underscores (_), lowercase characters, and numbers. Values must - contain only hyphens (-), underscores (_), lowercase characters, and - numbers. - - --max-worker-count=MAX_WORKER_COUNT - The maximum number of workers to be used for parallel processing. - Defaults to 10 if not specified. - - --runtime-version=RUNTIME_VERSION - AI Platform runtime version for this job. Must be specified unless - --master-image-uri is specified instead. It is defined in documentation - along with the list of supported versions: - https://cloud.google.com/ai-platform/prediction/docs/runtime-version-list - - --signature-name=SIGNATURE_NAME - Name of the signature defined in the SavedModel to use for this job. - Defaults to DEFAULT_SERVING_SIGNATURE_DEF_KEY in - https://www.tensorflow.org/api_docs/python/tf/compat/v1/saved_model/signature_constants, - which is "serving_default". Only applies to TensorFlow models. - - --version=VERSION - Model version to be used. - - This flag may only be given if --model is specified. If unspecified, - the default version of the model will be used. To list versions for a - model, run - - $ gcloud ai-platform versions list - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -NOTES - These variants are also available: - - $ gcloud alpha ml-engine jobs submit prediction - - $ gcloud beta ml-engine jobs submit prediction - diff --git a/gcloud/ml-engine/jobs/submit/training b/gcloud/ml-engine/jobs/submit/training deleted file mode 100644 index 558739407..000000000 --- a/gcloud/ml-engine/jobs/submit/training +++ /dev/null @@ -1,418 +0,0 @@ -NAME - gcloud ml-engine jobs submit training - submit an AI Platform training job - -SYNOPSIS - gcloud ml-engine jobs submit training JOB [--config=CONFIG] - [--enable-web-access] [--job-dir=JOB_DIR] [--labels=[KEY=VALUE,...]] - [--master-accelerator=[count=COUNT],[type=TYPE]] - [--master-image-uri=MASTER_IMAGE_URI] - [--master-machine-type=MASTER_MACHINE_TYPE] [--module-name=MODULE_NAME] - [--package-path=PACKAGE_PATH] [--packages=[PACKAGE,...]] - [--parameter-server-accelerator=[count=COUNT],[type=TYPE]] - [--parameter-server-image-uri=PARAMETER_SERVER_IMAGE_URI] - [--python-version=PYTHON_VERSION] [--region=REGION] - [--runtime-version=RUNTIME_VERSION] [--scale-tier=SCALE_TIER] - [--service-account=SERVICE_ACCOUNT] [--staging-bucket=STAGING_BUCKET] - [--use-chief-in-tf-config=USE_CHIEF_IN_TF_CONFIG] - [--worker-accelerator=[count=COUNT],[type=TYPE]] - [--worker-image-uri=WORKER_IMAGE_URI] [--async | --stream-logs] - [--kms-key=KMS_KEY : --kms-keyring=KMS_KEYRING - --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT] - [--parameter-server-count=PARAMETER_SERVER_COUNT - --parameter-server-machine-type=PARAMETER_SERVER_MACHINE_TYPE] - [--worker-count=WORKER_COUNT --worker-machine-type=WORKER_MACHINE_TYPE] - [GCLOUD_WIDE_FLAG ...] [-- USER_ARGS ...] - -DESCRIPTION - Submit an AI Platform training job. - - This creates temporary files and executes Python code staged by a user on - Cloud Storage. Model code can either be specified with a path, e.g.: - - $ gcloud ml-engine jobs submit training my_job \ - --module-name trainer.task \ - --staging-bucket gs://my-bucket \ - --package-path /my/code/path/trainer \ - --packages additional-dep1.tar.gz,dep2.whl - - Or by specifying an already built package: - - $ gcloud ml-engine jobs submit training my_job \ - --module-name trainer.task \ - --staging-bucket gs://my-bucket \ - --packages trainer-0.0.1.tar.gz,additional-dep1.tar.gz,dep2.whl - - If --package-path=/my/code/path/trainer is specified and there is a - setup.py file at /my/code/path/setup.py, the setup file will be invoked - with sdist and the generated tar files will be uploaded to Cloud Storage. - Otherwise, a temporary setup.py file will be generated for the build. - - By default, this command runs asynchronously; it exits once the job is - successfully submitted. - - To follow the progress of your job, pass the --stream-logs flag (note that - even with the --stream-logs flag, the job will continue to run after this - command exits and must be cancelled with gcloud ai-platform jobs cancel - JOB_ID). - - For more information, see: - https://cloud.google.com/ai-platform/training/docs/overview - -POSITIONAL ARGUMENTS - JOB - Name of the job. - - [-- USER_ARGS ...] - Additional user arguments to be forwarded to user code - - The '--' argument must be specified between gcloud specific args on the - left and USER_ARGS on the right. - -FLAGS - --config=CONFIG - Path to the job configuration file. This file should be a YAML document - (JSON also accepted) containing a Job resource as defined in the API - (all fields are optional): - https://cloud.google.com/ml/reference/rest/v1/projects.jobs - - EXAMPLES: - - JSON: - - { - "jobId": "my_job", - "labels": { - "type": "prod", - "owner": "alice" - }, - "trainingInput": { - "scaleTier": "BASIC", - "packageUris": [ - "gs://my/package/path" - ], - "region": "us-east1" - } - } - - YAML: - - jobId: my_job - labels: - type: prod - owner: alice - trainingInput: - scaleTier: BASIC - packageUris: - - gs://my/package/path - region: us-east1 - - If an option is specified both in the configuration file **and** via - command line arguments, the command line arguments override the - configuration file. - - --enable-web-access - Whether you want AI Platform Training to enable [interactive shell - access] - (https://cloud.google.com/ai-platform/training/docs/monitor-debug-interactive-shell) - to training containers. If set to true, you can access interactive - shells at the URIs given by TrainingOutput.web_access_uris or - HyperparameterOutput.web_access_uris (within TrainingOutput.trials). - - --job-dir=JOB_DIR - Cloud Storage path in which to store training outputs and other data - needed for training. - - This path will be passed to your TensorFlow program as the --job-dir - command-line arg. The benefit of specifying this field is that AI - Platform will validate the path for use in training. However, note that - your training program will need to parse the provided --job-dir - argument. - - If packages must be uploaded and --staging-bucket is not provided, this - path will be used instead. - - --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. - - --master-accelerator=[count=COUNT],[type=TYPE] - Hardware accelerator config for the master worker. Must specify both - the accelerator type (TYPE) for each server and the number of - accelerators to attach to each server (COUNT). - - type - Type of the accelerator. Choices are - nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4-pod - - count - Number of accelerators to attach to each machine running the job. - Must be greater than 0. - - --master-image-uri=MASTER_IMAGE_URI - Docker image to run on each master worker. This image must be in - Container Registry. Only one of --master-image-uri and - --runtime-version must be specified. - - --master-machine-type=MASTER_MACHINE_TYPE - Specifies the type of virtual machine to use for training job's master - worker. - - You must set this value when --scale-tier is set to CUSTOM. - - --module-name=MODULE_NAME - Name of the module to run. - - --package-path=PACKAGE_PATH - Path to a Python package to build. This should point to a local - directory containing the Python source for the job. It will be built - using setuptools (which must be installed) using its parent directory - as context. If the parent directory contains a setup.py file, the build - will use that; otherwise, it will use a simple built-in one. - - --packages=[PACKAGE,...] - Path to Python archives used for training. These can be local paths - (absolute or relative), in which case they will be uploaded to the - Cloud Storage bucket given by --staging-bucket, or Cloud Storage URLs - ('gs://bucket-name/path/to/package.tar.gz'). - - --parameter-server-accelerator=[count=COUNT],[type=TYPE] - Hardware accelerator config for the parameter servers. Must specify - both the accelerator type (TYPE) for each server and the number of - accelerators to attach to each server (COUNT). - - type - Type of the accelerator. Choices are - nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4-pod - - count - Number of accelerators to attach to each machine running the job. - Must be greater than 0. - - --parameter-server-image-uri=PARAMETER_SERVER_IMAGE_URI - Docker image to run on each parameter server. This image must be in - Container Registry. If not specified, the value of --master-image-uri - is used. - - --python-version=PYTHON_VERSION - Version of Python used during training. Choices are 3.7, 3.5, and 2.7. - However, this value must be compatible with the chosen runtime version - for the job. - - Must be used with a compatible runtime version: - - ◆ 3.7 is compatible with runtime versions 1.15 and later. - ◆ 3.5 is compatible with runtime versions 1.4 through 1.14. - ◆ 2.7 is compatible with runtime versions 1.15 and earlier. - - --region=REGION - Region of the machine learning training job to submit. If not - specified, you might be prompted to select a region (interactive mode - only). - - To avoid prompting when this flag is omitted, you can set the - compute/region property: - - $ gcloud config set compute/region REGION - - A list of regions can be fetched by running: - - $ gcloud compute regions list - - To unset the property, run: - - $ gcloud config unset compute/region - - Alternatively, the region can be stored in the environment variable - CLOUDSDK_COMPUTE_REGION. - - --runtime-version=RUNTIME_VERSION - AI Platform runtime version for this job. Must be specified unless - --master-image-uri is specified instead. It is defined in documentation - along with the list of supported versions: - https://cloud.google.com/ai-platform/prediction/docs/runtime-version-list - - --scale-tier=SCALE_TIER - Specify the machine types, the number of replicas for workers, and - parameter servers. SCALE_TIER must be one of: - - basic - Single worker instance. This tier is suitable for learning how to - use AI Platform, and for experimenting with new models using small - datasets. - basic-gpu - Single worker instance with a GPU. - basic-tpu - Single worker instance with a Cloud TPU. - custom - CUSTOM tier is not a set tier, but rather enables you to use your - own cluster specification. When you use this tier, set values to - configure your processing cluster according to these guidelines - (using the --config flag): - - ▸ You must set TrainingInput.masterType to specify the type of - machine to use for your master node. This is the only required - setting. - ▸ You may set TrainingInput.workerCount to specify the number of - workers to use. If you specify one or more workers, you must also - set TrainingInput.workerType to specify the type of machine to - use for your worker nodes. - ▸ You may set TrainingInput.parameterServerCount to specify the - number of parameter servers to use. If you specify one or more - parameter servers, you must also set - TrainingInput.parameterServerType to specify the type of machine - to use for your parameter servers. Note that all of your workers - must use the same machine type, which can be different from your - parameter server type and master type. Your parameter servers - must likewise use the same machine type, which can be different - from your worker type and master type. - premium-1 - Large number of workers with many parameter servers. - standard-1 - Many workers and a few parameter servers. - - --service-account=SERVICE_ACCOUNT - The email address of a service account to use when running the training - appplication. You must have the iam.serviceAccounts.actAs permission - for the specified service account. In addition, the AI Platform - Training Google-managed service account must have the - roles/iam.serviceAccountAdmin role for the specified service account. - Learn more about configuring a service account. - (https://cloud.google.com/ai-platform/training/docs/custom-service-account) - If not specified, the AI Platform Training Google-managed service - account is used by default. - - --staging-bucket=STAGING_BUCKET - Bucket in which to stage training archives. - - Required only if a file upload is necessary (that is, other flags - include local paths) and no other flags implicitly specify an upload - path. - - --use-chief-in-tf-config=USE_CHIEF_IN_TF_CONFIG - Use "chief" role in the cluster instead of "master". This is required - for TensorFlow 2.0 and newer versions. Unlike "master" node, "chief" - node does not run evaluation. - - --worker-accelerator=[count=COUNT],[type=TYPE] - Hardware accelerator config for the worker nodes. Must specify both the - accelerator type (TYPE) for each server and the number of accelerators - to attach to each server (COUNT). - - type - Type of the accelerator. Choices are - nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4-pod - - count - Number of accelerators to attach to each machine running the job. - Must be greater than 0. - - --worker-image-uri=WORKER_IMAGE_URI - Docker image to run on each worker node. This image must be in - Container Registry. If not specified, the value of --master-image-uri - is used. - - At most one of these can be specified: - - --async - (DEPRECATED) Display information about the operation in progress - without waiting for the operation to complete. Enabled by default and - can be omitted; use --stream-logs to run synchronously. - - --stream-logs - Block until job completion and stream the logs while the job runs. - - Note that even if command execution is halted, the job will still run - until cancelled with - - $ gcloud ai-platform jobs cancel JOB_ID - - Key resource - The Cloud KMS (Key Management Service) cryptokey that will - be used to protect the job. The 'AI Platform Service Agent' service - account must hold permission 'Cloud KMS CryptoKey Encrypter/Decrypter'. - The arguments in this group can be used to specify the attributes of this - resource. - - --kms-key=KMS_KEY - ID of the key or fully qualified identifier for the key. - - To set the kms-key attribute: - ▸ provide the argument --kms-key on the command line. - - This flag argument must be specified if any of the other arguments in - this group are specified. - - --kms-keyring=KMS_KEYRING - The KMS keyring of the key. - - To set the kms-keyring attribute: - ▸ provide the argument --kms-key on the command line with a fully - specified name; - ▸ provide the argument --kms-keyring on the command line. - - --kms-location=KMS_LOCATION - The Google Cloud location for the key. - - To set the kms-location attribute: - ▸ provide the argument --kms-key on the command line with a fully - specified name; - ▸ provide the argument --kms-location on the command line. - - --kms-project=KMS_PROJECT - The Google Cloud project for the key. - - To set the kms-project attribute: - ▸ provide the argument --kms-key on the command line with a fully - specified name; - ▸ provide the argument --kms-project on the command line; - ▸ set the property core/project. - - Configure parameter server machine type settings. - - --parameter-server-count=PARAMETER_SERVER_COUNT - Number of parameter servers to use for the training job. - - This flag argument must be specified if any of the other arguments in - this group are specified. - - --parameter-server-machine-type=PARAMETER_SERVER_MACHINE_TYPE - Type of virtual machine to use for training job's parameter servers. - This flag must be specified if any of the other arguments in this - group are specified machine to use for training job's parameter - servers. - - This flag argument must be specified if any of the other arguments in - this group are specified. - - Configure worker node machine type settings. - - --worker-count=WORKER_COUNT - Number of worker nodes to use for the training job. - - This flag argument must be specified if any of the other arguments in - this group are specified. - - --worker-machine-type=WORKER_MACHINE_TYPE - Type of virtual machine to use for training job's worker nodes. - - This flag argument must be specified if any of the other arguments in - this group are specified. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine jobs submit training - - $ gcloud beta ml-engine jobs submit training - diff --git a/gcloud/ml-engine/jobs/update b/gcloud/ml-engine/jobs/update deleted file mode 100644 index 67ba43196..000000000 --- a/gcloud/ml-engine/jobs/update +++ /dev/null @@ -1,64 +0,0 @@ -NAME - gcloud ml-engine jobs update - update an AI Platform job - -SYNOPSIS - gcloud ml-engine jobs update JOB [--update-labels=[KEY=VALUE,...]] - [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Update an AI Platform job. - -EXAMPLES - To remove all labels in the AI Platform job named my-job, run: - - $ gcloud ml-engine jobs update my-job --clear-labels - -POSITIONAL ARGUMENTS - JOB - Name of the job. - -FLAGS - --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 ml-engine jobs update --clear-labels - - To remove all existing labels and create two new labels, foo and baz: - - $ gcloud ml-engine jobs 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 - These variants are also available: - - $ gcloud alpha ml-engine jobs update - - $ gcloud beta ml-engine jobs update - diff --git a/gcloud/ml-engine/local/help b/gcloud/ml-engine/local/help deleted file mode 100644 index 9e5a73a51..000000000 --- a/gcloud/ml-engine/local/help +++ /dev/null @@ -1,30 +0,0 @@ -NAME - gcloud ml-engine local - AI Platform Local commands - -SYNOPSIS - gcloud ml-engine local COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - AI Platform Local commands. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -COMMANDS - COMMAND is one of the following: - - predict - Run prediction locally. - - train - Run an AI Platform training job locally. - -NOTES - These variants are also available: - - $ gcloud alpha ml-engine local - - $ gcloud beta ml-engine local - diff --git a/gcloud/ml-engine/local/predict b/gcloud/ml-engine/local/predict deleted file mode 100644 index ea653e683..000000000 --- a/gcloud/ml-engine/local/predict +++ /dev/null @@ -1,88 +0,0 @@ -NAME - gcloud ml-engine local predict - run prediction locally - -SYNOPSIS - gcloud ml-engine local predict --model-dir=MODEL_DIR - (--json-instances=JSON_INSTANCES | --json-request=JSON_REQUEST - | --text-instances=TEXT_INSTANCES) [--framework=FRAMEWORK] - [--signature-name=SIGNATURE_NAME] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - gcloud ml-engine local predict performs prediction locally with the given - instances. It requires the TensorFlow SDK - (https://www.tensorflow.org/install) be installed locally. The output - format mirrors gcloud ai-platform predict (online prediction). - - You cannot use this command with custom prediction routines. - -REQUIRED FLAGS - --model-dir=MODEL_DIR - Path to the model. - - Exactly one of these must be specified: - - --json-instances=JSON_INSTANCES - Path to a local file from which instances are read. Instances are in - JSON format; newline delimited. - - An example of the JSON instances file: - - {"images": [0.0, ..., 0.1], "key": 3} - {"images": [0.0, ..., 0.1], "key": 2} - ... - - This flag accepts "-" for stdin. - - --json-request=JSON_REQUEST - Path to a local file containing the body of JSON request. - - An example of a JSON request: - - { - "instances": [ - {"x": [1, 2], "y": [3, 4]}, - {"x": [-1, -2], "y": [-3, -4]} - ] - } - - This flag accepts "-" for stdin. - - --text-instances=TEXT_INSTANCES - Path to a local file from which instances are read. Instances are in - UTF-8 encoded text format; newline delimited. - - An example of the text instances file: - - 107,4.9,2.5,4.5,1.7 - 100,5.7,2.8,4.1,1.3 - ... - - This flag accepts "-" for stdin. - -OPTIONAL FLAGS - --framework=FRAMEWORK - ML framework used to train this version of the model. If not specified, - defaults to 'tensorflow'. FRAMEWORK must be one of: scikit-learn, - tensorflow, xgboost. - - --signature-name=SIGNATURE_NAME - Name of the signature defined in the SavedModel to use for this job. - Defaults to DEFAULT_SERVING_SIGNATURE_DEF_KEY in - https://www.tensorflow.org/api_docs/python/tf/compat/v1/saved_model/signature_constants, - which is "serving_default". Only applies to TensorFlow models. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine local predict - - $ gcloud beta ml-engine local predict - diff --git a/gcloud/ml-engine/local/train b/gcloud/ml-engine/local/train deleted file mode 100644 index 7a7644318..000000000 --- a/gcloud/ml-engine/local/train +++ /dev/null @@ -1,107 +0,0 @@ -NAME - gcloud ml-engine local train - run an AI Platform training job locally - -SYNOPSIS - gcloud ml-engine local train --module-name=MODULE_NAME [--distributed] - [--evaluator-count=EVALUATOR_COUNT] [--job-dir=JOB_DIR] - [--package-path=PACKAGE_PATH] - [--parameter-server-count=PARAMETER_SERVER_COUNT] - [--start-port=START_PORT; default=27182] [--worker-count=WORKER_COUNT] - [GCLOUD_WIDE_FLAG ...] [-- USER_ARGS ...] - -DESCRIPTION - This command runs the specified module in an environment similar to that of - a live AI Platform Training Job. - - This is especially useful in the case of testing distributed models, as it - allows you to validate that you are properly interacting with the AI - Platform cluster configuration. If your model expects a specific number of - parameter servers or workers (i.e. you expect to use the CUSTOM machine - type), use the --parameter-server-count and --worker-count flags to further - specify the desired cluster configuration, just as you would in your cloud - training job configuration: - - $ gcloud ml-engine local train --module-name trainer.task \ - --package-path /path/to/my/code/trainer \ - --distributed \ - --parameter-server-count 4 \ - --worker-count 8 - - Unlike submitting a training job, the --package-path parameter can be - omitted, and will use your current working directory. - - AI Platform Training sets a TF_CONFIG environment variable on each VM in - your training job. You can use TF_CONFIG to access the cluster description - and the task description for each VM. - - Learn more about TF_CONFIG: - https://cloud.google.com/ai-platform/training/docs/distributed-training-details. - -POSITIONAL ARGUMENTS - [-- USER_ARGS ...] - Additional user arguments to be forwarded to user code. Any relative - paths will be relative to the parent directory of --package-path. - - The '--' argument must be specified between gcloud specific args on the - left and USER_ARGS on the right. - -REQUIRED FLAGS - --module-name=MODULE_NAME - Name of the module to run. - -OPTIONAL FLAGS - --distributed - Runs the provided code in distributed mode by providing cluster - configurations as environment variables to subprocesses - - --evaluator-count=EVALUATOR_COUNT - Number of evaluators with which to run. Ignored if --distributed is not - specified. Default: 0 - - --job-dir=JOB_DIR - Cloud Storage path or local_directory in which to store training - outputs and other data needed for training. - - This path will be passed to your TensorFlow program as the --job-dir - command-line arg. The benefit of specifying this field is that AI - Platform will validate the path for use in training. However, note that - your training program will need to parse the provided --job-dir - argument. - - --package-path=PACKAGE_PATH - Path to a Python package to build. This should point to a local - directory containing the Python source for the job. It will be built - using setuptools (which must be installed) using its parent directory - as context. If the parent directory contains a setup.py file, the build - will use that; otherwise, it will use a simple built-in one. - - --parameter-server-count=PARAMETER_SERVER_COUNT - Number of parameter servers with which to run. Ignored if --distributed - is not specified. Default: 2 - - --start-port=START_PORT; default=27182 - Start of the range of ports reserved by the local cluster. This command - will use a contiguous block of ports equal to parameter-server-count + - worker-count + 1. - - If --distributed is not specified, this flag is ignored. - - --worker-count=WORKER_COUNT - Number of workers with which to run. Ignored if --distributed is not - specified. Default: 2 - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine local train - - $ gcloud beta ml-engine local train - diff --git a/gcloud/ml-engine/models/add-iam-policy-binding b/gcloud/ml-engine/models/add-iam-policy-binding deleted file mode 100644 index 716380a41..000000000 --- a/gcloud/ml-engine/models/add-iam-policy-binding +++ /dev/null @@ -1,88 +0,0 @@ -NAME - gcloud ml-engine models add-iam-policy-binding - add IAM policy binding for - a model - -SYNOPSIS - gcloud ml-engine models add-iam-policy-binding MODEL --member=PRINCIPAL - --role=ROLE [--region=REGION] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Add IAM policy binding to a model. - -EXAMPLES - To add an IAM policy binding for the role of roles/ml.admin for the user - test-user@gmail.com on a model with identifier my_model, run: - - $ gcloud ml-engine models add-iam-policy-binding my_model \ - --member='user:test-user@gmail.com' --role='roles/ml.admin' - - To add an IAM policy binding for the role of roles/ml.admin to the service - account test-proj1@example.domain.com, run: - - $ gcloud ml-engine models add-iam-policy-binding my_model \ - --member='serviceAccount:test-proj1@example.domain.com' \ - --role='roles/ml.admin' - - To add an IAM policy binding for the role of roles/ml.admin for all - authenticated users on a model with identifier my_model, run: - - $ gcloud ml-engine models add-iam-policy-binding my_model \ - --member='allAuthenticatedUsers' --role='roles/ml.admin' - - See https://cloud.google.com/iam/docs/managing-policies for details of - policy role and principal types. - -POSITIONAL ARGUMENTS - MODEL - Name of the model. - -REQUIRED FLAGS - --member=PRINCIPAL - The principal to add the binding for. Should be of the form - user|group|serviceAccount:email or domain:domain. - - Examples: user:test-user@gmail.com, group:admins@example.com, - serviceAccount:test123@example.domain.com, or - domain:example.domain.com. - - Some resources also accept the following special values: - ◆ allUsers - Special identifier that represents anyone who is on the - internet, with or without a Google account. - ◆ allAuthenticatedUsers - Special identifier that represents anyone - who is authenticated with a Google account or a service account. - - --role=ROLE - Role name to assign to the principal. The role name is the complete - path of a predefined role, such as roles/logging.viewer, or the role ID - for a custom role, such as - organizations/{ORGANIZATION_ID}/roles/logging.viewer. - -OPTIONAL FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine models add-iam-policy-binding - - $ gcloud beta ml-engine models add-iam-policy-binding - diff --git a/gcloud/ml-engine/models/create b/gcloud/ml-engine/models/create deleted file mode 100644 index cc9ed9387..000000000 --- a/gcloud/ml-engine/models/create +++ /dev/null @@ -1,80 +0,0 @@ -NAME - gcloud ml-engine models create - create a new AI Platform model - -SYNOPSIS - gcloud ml-engine models create MODEL [--description=DESCRIPTION] - [--enable-logging] [--labels=[KEY=VALUE,...]] - [--region=REGION | --regions=REGION,[REGION,...]] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Create a new AI Platform model. - -POSITIONAL ARGUMENTS - MODEL - Name of the model. - -FLAGS - --description=DESCRIPTION - Description of the model. - - --enable-logging - If set, enables StackDriver Logging for online prediction. These logs - are like standard server access logs, containing information such as - timestamps and latency for each request. - - --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 these can be specified: - - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - - If you specify this flag, do not specify --regions. - - If you specify --region=global, the model will be deployed to - 'us-central1' by default using the global endpoint. Please use - --regions only if you want to change the region where the model will - be deployed against the global endpoint. - - If both flags are unspecified and you don't set ai_platform/region, - you will be prompted for region of the regional endpoint. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - - --regions=REGION,[REGION,...] - The Google Cloud region where the model will be deployed (currently - only a single region is supported) against the global endpoint. - - If you specify this flag, do not specify --region. - - Defaults to 'us-central1' while using the global endpoint. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine models create - - $ gcloud beta ml-engine models create - diff --git a/gcloud/ml-engine/models/delete b/gcloud/ml-engine/models/delete deleted file mode 100644 index 82858c08e..000000000 --- a/gcloud/ml-engine/models/delete +++ /dev/null @@ -1,47 +0,0 @@ -NAME - gcloud ml-engine models delete - delete an existing AI Platform model - -SYNOPSIS - gcloud ml-engine models delete MODEL [--region=REGION] - [GCLOUD_WIDE_FLAG ...] - -EXAMPLES - To delete all models matching the regular expression vision[0-9]+, run: - - $ gcloud ml-engine models list --uri \ - --filter 'name ~ vision[0-9]+' | xargs -n 1 gcloud ml-engine \ - models delete - -POSITIONAL ARGUMENTS - MODEL - Name of the model. - -FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine models delete - - $ gcloud beta ml-engine models delete - diff --git a/gcloud/ml-engine/models/describe b/gcloud/ml-engine/models/describe deleted file mode 100644 index c3b1265bf..000000000 --- a/gcloud/ml-engine/models/describe +++ /dev/null @@ -1,46 +0,0 @@ -NAME - gcloud ml-engine models describe - describe an existing AI Platform model - -SYNOPSIS - gcloud ml-engine models describe MODEL [--region=REGION] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Describe an existing AI Platform model. - - If you would like to see all versions of a model, use gcloud ai-platform - versions list. - -POSITIONAL ARGUMENTS - MODEL - Name of the model. - -FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine models describe - - $ gcloud beta ml-engine models describe - diff --git a/gcloud/ml-engine/models/get-iam-policy b/gcloud/ml-engine/models/get-iam-policy deleted file mode 100644 index 100a572b5..000000000 --- a/gcloud/ml-engine/models/get-iam-policy +++ /dev/null @@ -1,92 +0,0 @@ -NAME - gcloud ml-engine models get-iam-policy - get the IAM policy for a model - -SYNOPSIS - gcloud ml-engine models get-iam-policy MODEL [--region=REGION] - [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] - [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Gets the IAM policy for the given model. - - Returns an empty policy if the resource does not have a policy set. - -EXAMPLES - The following command gets the IAM policy for the model my_model: - - $ gcloud ml-engine models get-iam-policy my_model - -POSITIONAL ARGUMENTS - Model resource - The AI Platform model to set IAM policy for. 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 model 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. - - MODEL - ID of the model or fully qualified identifier for the model. - - To set the name attribute: - ▸ provide the argument model on the command line. - -FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - -LIST COMMAND FLAGS - --filter=EXPRESSION - Apply a Boolean filter EXPRESSION to each resource item to be listed. - If the expression evaluates True, then that item is listed. For more - details and examples of filter expressions, run $ gcloud topic filters. - This flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --limit=LIMIT - Maximum number of resources to list. The default is unlimited. This - flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --page-size=PAGE_SIZE - Some services group resource list output into pages. This flag - specifies the maximum number of resources per page. The default is - determined by the service if it supports paging, otherwise it is - unlimited (no paging). Paging may be applied before or after --filter - and --limit depending on the service. - - --sort-by=[FIELD,...] - Comma-separated list of resource field key names to sort by. The - default order is ascending. Prefix a field with ``~'' for descending - order on that field. This flag interacts with other flags that are - applied in this order: --flatten, --sort-by, --filter, --limit. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -NOTES - These variants are also available: - - $ gcloud alpha ml-engine models get-iam-policy - - $ gcloud beta ml-engine models get-iam-policy - diff --git a/gcloud/ml-engine/models/help b/gcloud/ml-engine/models/help deleted file mode 100644 index b9be3a98b..000000000 --- a/gcloud/ml-engine/models/help +++ /dev/null @@ -1,58 +0,0 @@ -NAME - gcloud ml-engine models - AI Platform Models commands - -SYNOPSIS - gcloud ml-engine models COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - An AI Platform model is a container representing an ML application or - service. A model may contain multiple versions which act as the - implementation of the service. See also: - - $ gcloud ml-engine versions --help. - - For more information, please see - https://cloud.google.com/ml/docs/concepts/technical-overview#model - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -COMMANDS - COMMAND is one of the following: - - add-iam-policy-binding - Add IAM policy binding for a model. - - create - Create a new AI Platform model. - - delete - Delete an existing AI Platform model. - - describe - Describe an existing AI Platform model. - - get-iam-policy - Get the IAM policy for a model. - - list - List existing AI Platform models. - - remove-iam-policy-binding - Remove IAM policy binding for a model. - - set-iam-policy - Set the IAM policy for a model. - - update - Update an existing AI Platform model. - -NOTES - These variants are also available: - - $ gcloud alpha ml-engine models - - $ gcloud beta ml-engine models - diff --git a/gcloud/ml-engine/models/remove-iam-policy-binding b/gcloud/ml-engine/models/remove-iam-policy-binding deleted file mode 100644 index cba97c774..000000000 --- a/gcloud/ml-engine/models/remove-iam-policy-binding +++ /dev/null @@ -1,99 +0,0 @@ -NAME - gcloud ml-engine models remove-iam-policy-binding - remove IAM policy - binding for a model - -SYNOPSIS - gcloud ml-engine models remove-iam-policy-binding MODEL --member=PRINCIPAL - --role=ROLE [--region=REGION] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Removes a policy binding from an AI Platform Model. One binding consists of - a member, a role and an optional condition. See $ gcloud ml-engine models - get-iam-policy for examples of how to specify a model resource. - -EXAMPLES - To remove an IAM policy binding for the role of roles/ml.admin for the user - test-user@gmail.com on model with identifier my_model, run: - - $ gcloud ml-engine models remove-iam-policy-binding my_model \ - --member='user:test-user@gmail.com' --role='roles/ml.admin' - - To remove an IAM policy binding for the role of roles/ml.admin from all - authenticated users on model my_model, run: - - $ gcloud ml-engine models remove-iam-policy-binding my_model \ - --member='allAuthenticatedUsers' --role='roles/ml.admin' - - See https://cloud.google.com/iam/docs/managing-policies for details of - policy role and member types. - -POSITIONAL ARGUMENTS - Model resource - The AI Platform model for which to remove IAM policy - binding from. 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 model 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. - - MODEL - ID of the model or fully qualified identifier for the model. - - To set the name attribute: - ▸ provide the argument model on the command line. - -REQUIRED FLAGS - --member=PRINCIPAL - The principal to remove the binding for. Should be of the form - user|group|serviceAccount:email or domain:domain. - - Examples: user:test-user@gmail.com, group:admins@example.com, - serviceAccount:test123@example.domain.com, or - domain:example.domain.com. - - Deleted principals have an additional deleted: prefix and a ?uid=UID - suffix, where UID is a unique identifier for the principal. Example: - deleted:user:test-user@gmail.com?uid=123456789012345678901. - - Some resources also accept the following special values: - ◆ allUsers - Special identifier that represents anyone who is on the - internet, with or without a Google account. - ◆ allAuthenticatedUsers - Special identifier that represents anyone - who is authenticated with a Google account or a service account. - - --role=ROLE - The role to remove the principal from. - -OPTIONAL FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine models remove-iam-policy-binding - - $ gcloud beta ml-engine models remove-iam-policy-binding - diff --git a/gcloud/ml-engine/models/set-iam-policy b/gcloud/ml-engine/models/set-iam-policy deleted file mode 100644 index 9c5aede05..000000000 --- a/gcloud/ml-engine/models/set-iam-policy +++ /dev/null @@ -1,74 +0,0 @@ -NAME - gcloud ml-engine models set-iam-policy - set the IAM policy for a model - -SYNOPSIS - gcloud ml-engine models set-iam-policy MODEL POLICY_FILE [--region=REGION] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Sets the IAM policy for the given model as defined in a JSON or YAML file. - - See https://cloud.google.com/iam/docs/managing-policies for details of the - policy file format and contents. - -EXAMPLES - The following command will read am IAM policy defined in a JSON file - 'policy.json' and set it for the model my_model: - - $ gcloud ml-engine models set-iam-policy my_model policy.json - -POSITIONAL ARGUMENTS - Model resource - The AI Platform model to set IAM policy for. 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 model 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. - - MODEL - ID of the model or fully qualified identifier for the model. - - To set the name attribute: - ▸ provide the argument model on the command line. - - POLICY_FILE - Path to a local JSON or YAML formatted file containing a valid policy. - - The output of the get-iam-policy command is a valid file, as is any - JSON or YAML file conforming to the structure of a Policy - (https://cloud.google.com/iam/reference/rest/v1/Policy). - -FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine models set-iam-policy - - $ gcloud beta ml-engine models set-iam-policy - diff --git a/gcloud/ml-engine/models/update b/gcloud/ml-engine/models/update deleted file mode 100644 index 1e6267116..000000000 --- a/gcloud/ml-engine/models/update +++ /dev/null @@ -1,76 +0,0 @@ -NAME - gcloud ml-engine models update - update an existing AI Platform model - -SYNOPSIS - gcloud ml-engine models update MODEL [--description=DESCRIPTION] - [--region=REGION] [--update-labels=[KEY=VALUE,...]] - [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Update an existing AI Platform model. - -POSITIONAL ARGUMENTS - MODEL - Name of the model. - -FLAGS - --description=DESCRIPTION - Description of the model. - - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - - --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 ml-engine models update --clear-labels - - To remove all existing labels and create two new labels, foo and baz: - - $ gcloud ml-engine models 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 - These variants are also available: - - $ gcloud alpha ml-engine models update - - $ gcloud beta ml-engine models update - diff --git a/gcloud/ml-engine/operations/cancel b/gcloud/ml-engine/operations/cancel deleted file mode 100644 index 1a4e74970..000000000 --- a/gcloud/ml-engine/operations/cancel +++ /dev/null @@ -1,44 +0,0 @@ -NAME - gcloud ml-engine operations cancel - cancel an AI Platform operation - -SYNOPSIS - gcloud ml-engine operations cancel OPERATION [--region=REGION] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Cancel an AI Platform operation. - -POSITIONAL ARGUMENTS - OPERATION - Name of the operation. - -FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - If unspecified, the command uses the global endpoint of the AI Platform - Training and Prediction API. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: asia-east1, asia-northeast1, asia-southeast1, - australia-southeast1, europe-west1, europe-west2, europe-west3, - europe-west4, northamerica-northeast1, us-central1, us-east1, us-east4, - us-west1. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine operations cancel - - $ gcloud beta ml-engine operations cancel - diff --git a/gcloud/ml-engine/operations/describe b/gcloud/ml-engine/operations/describe deleted file mode 100644 index 272772c24..000000000 --- a/gcloud/ml-engine/operations/describe +++ /dev/null @@ -1,44 +0,0 @@ -NAME - gcloud ml-engine operations describe - describe an AI Platform operation - -SYNOPSIS - gcloud ml-engine operations describe OPERATION [--region=REGION] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Describe an AI Platform operation. - -POSITIONAL ARGUMENTS - OPERATION - Name of the operation. - -FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - If unspecified, the command uses the global endpoint of the AI Platform - Training and Prediction API. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: asia-east1, asia-northeast1, asia-southeast1, - australia-southeast1, europe-west1, europe-west2, europe-west3, - europe-west4, northamerica-northeast1, us-central1, us-east1, us-east4, - us-west1. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine operations describe - - $ gcloud beta ml-engine operations describe - diff --git a/gcloud/ml-engine/operations/help b/gcloud/ml-engine/operations/help deleted file mode 100644 index d02376a5c..000000000 --- a/gcloud/ml-engine/operations/help +++ /dev/null @@ -1,36 +0,0 @@ -NAME - gcloud ml-engine operations - manage AI Platform operations - -SYNOPSIS - gcloud ml-engine operations COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Manage AI Platform operations. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -COMMANDS - COMMAND is one of the following: - - cancel - Cancel an AI Platform operation. - - describe - Describe an AI Platform operation. - - list - List existing AI Platform jobs. - - wait - Wait for an AI Platform operation to complete. - -NOTES - These variants are also available: - - $ gcloud alpha ml-engine operations - - $ gcloud beta ml-engine operations - diff --git a/gcloud/ml-engine/operations/list b/gcloud/ml-engine/operations/list deleted file mode 100644 index 8a718b723..000000000 --- a/gcloud/ml-engine/operations/list +++ /dev/null @@ -1,73 +0,0 @@ -NAME - gcloud ml-engine operations list - list existing AI Platform jobs - -SYNOPSIS - gcloud ml-engine operations list [--region=REGION] [--filter=EXPRESSION] - [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - List existing AI Platform jobs. - -FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - If unspecified, the command uses the global endpoint of the AI Platform - Training and Prediction API. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: asia-east1, asia-northeast1, asia-southeast1, - australia-southeast1, europe-west1, europe-west2, europe-west3, - europe-west4, northamerica-northeast1, us-central1, us-east1, us-east4, - us-west1. - -LIST COMMAND FLAGS - --filter=EXPRESSION - Apply a Boolean filter EXPRESSION to each resource item to be listed. - If the expression evaluates True, then that item is listed. For more - details and examples of filter expressions, run $ gcloud topic filters. - This flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --limit=LIMIT - Maximum number of resources to list. The default is unlimited. This - flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --page-size=PAGE_SIZE - Some services group resource list output into pages. This flag - specifies the maximum number of resources per page. The default is - determined by the service if it supports paging, otherwise it is - unlimited (no paging). Paging may be applied before or after --filter - and --limit depending on the service. - - --sort-by=[FIELD,...] - Comma-separated list of resource field key names to sort by. The - default order is ascending. Prefix a field with ``~'' for descending - order on that field. This flag interacts with other flags that are - applied in this order: --flatten, --sort-by, --filter, --limit. - - --uri - Print a list of resource URIs instead of the default output, and change - the command output to a list of URIs. If this flag is used with - --format, the formatting is applied on this URI list. To display URIs - alongside other keys instead, use the uri() transform. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -NOTES - These variants are also available: - - $ gcloud alpha ml-engine operations list - - $ gcloud beta ml-engine operations list - diff --git a/gcloud/ml-engine/operations/wait b/gcloud/ml-engine/operations/wait deleted file mode 100644 index eb085d410..000000000 --- a/gcloud/ml-engine/operations/wait +++ /dev/null @@ -1,49 +0,0 @@ -NAME - gcloud ml-engine operations wait - wait for an AI Platform operation to - complete - -SYNOPSIS - gcloud ml-engine operations wait OPERATION [--region=REGION] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Wait for an AI Platform operation to complete. - - Given an operation ID, this command polls the operation and blocks until it - completes. At completion, the operation message is printed (which includes - the operation response). - -POSITIONAL ARGUMENTS - OPERATION - Name of the operation. - -FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - If unspecified, the command uses the global endpoint of the AI Platform - Training and Prediction API. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: asia-east1, asia-northeast1, asia-southeast1, - australia-southeast1, europe-west1, europe-west2, europe-west3, - europe-west4, northamerica-northeast1, us-central1, us-east1, us-east4, - us-west1. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine operations wait - - $ gcloud beta ml-engine operations wait - diff --git a/gcloud/ml-engine/predict b/gcloud/ml-engine/predict deleted file mode 100644 index 7ccd665e4..000000000 --- a/gcloud/ml-engine/predict +++ /dev/null @@ -1,106 +0,0 @@ -NAME - gcloud ml-engine predict - run AI Platform online prediction - -SYNOPSIS - gcloud ml-engine predict --model=MODEL - (--json-instances=JSON_INSTANCES | --json-request=JSON_REQUEST - | --text-instances=TEXT_INSTANCES) [--region=REGION] - [--signature-name=SIGNATURE_NAME] [--version=VERSION] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - gcloud ml-engine predict sends a prediction request to AI Platform for the - given instances. This command will read up to 100 instances, though the - service itself will accept instances up to the payload limit size - (currently, 1.5MB). If you are predicting on more instances, you should use - batch prediction via - - $ gcloud ml-engine jobs submit prediction. - -REQUIRED FLAGS - --model=MODEL - Name of the model. - - Exactly one of these must be specified: - - --json-instances=JSON_INSTANCES - Path to a local file from which instances are read. Instances are in - JSON format; newline delimited. - - An example of the JSON instances file: - - {"images": [0.0, ..., 0.1], "key": 3} - {"images": [0.0, ..., 0.1], "key": 2} - ... - - This flag accepts "-" for stdin. - - --json-request=JSON_REQUEST - Path to a local file containing the body of JSON request. - - An example of a JSON request: - - { - "instances": [ - {"x": [1, 2], "y": [3, 4]}, - {"x": [-1, -2], "y": [-3, -4]} - ] - } - - This flag accepts "-" for stdin. - - --text-instances=TEXT_INSTANCES - Path to a local file from which instances are read. Instances are in - UTF-8 encoded text format; newline delimited. - - An example of the text instances file: - - 107,4.9,2.5,4.5,1.7 - 100,5.7,2.8,4.1,1.3 - ... - - This flag accepts "-" for stdin. - -OPTIONAL FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - - --signature-name=SIGNATURE_NAME - Name of the signature defined in the SavedModel to use for this job. - Defaults to DEFAULT_SERVING_SIGNATURE_DEF_KEY in - https://www.tensorflow.org/api_docs/python/tf/compat/v1/saved_model/signature_constants, - which is "serving_default". Only applies to TensorFlow models. - - --version=VERSION - Model version to be used. - - If unspecified, the default version of the model will be used. To list - model versions run - - $ gcloud ml-engine versions list - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -NOTES - These variants are also available: - - $ gcloud alpha ml-engine predict - - $ gcloud beta ml-engine predict - diff --git a/gcloud/ml-engine/versions/create b/gcloud/ml-engine/versions/create deleted file mode 100644 index 01e61d6fd..000000000 --- a/gcloud/ml-engine/versions/create +++ /dev/null @@ -1,183 +0,0 @@ -NAME - gcloud ml-engine versions create - create a new AI Platform version - -SYNOPSIS - gcloud ml-engine versions create VERSION --model=MODEL - [--accelerator=[count=COUNT],[type=TYPE]] [--async] [--config=CONFIG] - [--description=DESCRIPTION] [--framework=FRAMEWORK] - [--labels=[KEY=VALUE,...]] [--machine-type=MACHINE_TYPE] - [--origin=ORIGIN] [--python-version=PYTHON_VERSION] [--region=REGION] - [--runtime-version=RUNTIME_VERSION] [--staging-bucket=STAGING_BUCKET] - [--max-nodes=MAX_NODES - --metric-targets=[METRIC-NAME=TARGET,...] --min-nodes=MIN_NODES] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Creates a new version of an AI Platform model. - - For more details on managing AI Platform models and versions see - https://cloud.google.com/ai-platform/prediction/docs/managing-models-jobs - -EXAMPLES - To create an AI Platform version model with the version ID 'versionId' and - with the name 'model-name', run: - - $ gcloud ml-engine versions create versionId --model=model-name - -POSITIONAL ARGUMENTS - VERSION - Name of the model version. - -REQUIRED FLAGS - --model=MODEL - Name of the model. - -OPTIONAL FLAGS - --accelerator=[count=COUNT],[type=TYPE] - Manage the accelerator config for GPU serving. When deploying a model - with Compute Engine Machine Types, a GPU accelerator may also be - selected. - - type - The type of the accelerator. Choices are 'nvidia-tesla-a100', - 'nvidia-tesla-k80', 'nvidia-tesla-p100', 'nvidia-tesla-p4', - 'nvidia-tesla-t4', 'nvidia-tesla-v100'. - - count - The number of accelerators to attach to each machine running the - job. If not specified, the default value is 1. Your model must be - specially designed to accommodate more than 1 accelerator per - machine. To configure how many replicas your model has, set the - manualScaling or autoScaling parameters. - - --async - Return immediately, without waiting for the operation in progress to - complete. - - --config=CONFIG - Path to a YAML configuration file containing configuration parameters - for the Version - (https://cloud.google.com/ai-platform/prediction/docs/reference/rest/v1/projects.models.versions) - to create. - - The file is in YAML format. Note that not all attributes of a version - are configurable; available attributes (with example values) are: - - description: A free-form description of the version. - deploymentUri: gs://path/to/source - runtimeVersion: '2.1' - # Set only one of either manualScaling or autoScaling. - manualScaling: - nodes: 10 # The number of nodes to allocate for this model. - autoScaling: - minNodes: 0 # The minimum number of nodes to allocate for this model. - labels: - user-defined-key: user-defined-value - - The name of the version must always be specified via the required - VERSION argument. - - Only one of manualScaling or autoScaling can be specified. If both are - specified in same yaml file an error will be returned. - - If an option is specified both in the configuration file and via - command-line arguments, the command-line arguments override the - configuration file. - - --description=DESCRIPTION - Description of the version. - - --framework=FRAMEWORK - ML framework used to train this version of the model. If not specified, - defaults to 'tensorflow'. FRAMEWORK must be one of: scikit-learn, - tensorflow, xgboost. - - --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. - - --machine-type=MACHINE_TYPE - Type of machine on which to serve the model. Currently only applies to - online prediction. For available machine types, see - https://cloud.google.com/ai-platform/prediction/docs/machine-types-online-prediction#available_machine_types. - - --origin=ORIGIN - Location of model/ "directory" (see - https://cloud.google.com/ai-platform/prediction/docs/deploying-models#upload-model). - - This overrides deploymentUri in the --config file. If this flag is not - passed, deploymentUri must be specified in the file from --config. - - Can be a Cloud Storage (gs://) path or local file path (no prefix). In - the latter case the files will be uploaded to Cloud Storage and a - --staging-bucket argument is required. - - --python-version=PYTHON_VERSION - Version of Python used when creating the version. Choices are 3.7, 3.5, - and 2.7. However, this value must be compatible with the chosen runtime - version for the job. - - Must be used with a compatible runtime version: - - ◆ 3.7 is compatible with runtime versions 1.15 and later. - ◆ 3.5 is compatible with runtime versions 1.4 through 1.14. - ◆ 2.7 is compatible with runtime versions 1.15 and earlier. - - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - - --runtime-version=RUNTIME_VERSION - AI Platform runtime version for this job. Must be specified unless - --master-image-uri is specified instead. It is defined in documentation - along with the list of supported versions: - https://cloud.google.com/ai-platform/prediction/docs/runtime-version-list - - --staging-bucket=STAGING_BUCKET - Bucket in which to stage training archives. - - Required only if a file upload is necessary (that is, other flags - include local paths) and no other flags implicitly specify an upload - path. - - Configure the autoscaling settings to be deployed. - - --max-nodes=MAX_NODES - The maximum number of nodes to scale this model under load. - - --metric-targets=[METRIC-NAME=TARGET,...] - List of key-value pairs to set as metrics' target for autoscaling. - Autoscaling could be based on CPU usage or GPU duty cycle, valid key - could be cpu-usage or gpu-duty-cycle. - - --min-nodes=MIN_NODES - The minimum number of nodes to scale this model under load. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine versions create - - $ gcloud beta ml-engine versions create - diff --git a/gcloud/ml-engine/versions/delete b/gcloud/ml-engine/versions/delete deleted file mode 100644 index 5fed19738..000000000 --- a/gcloud/ml-engine/versions/delete +++ /dev/null @@ -1,47 +0,0 @@ -NAME - gcloud ml-engine versions delete - delete an existing AI Platform version - -SYNOPSIS - gcloud ml-engine versions delete VERSION --model=MODEL [--region=REGION] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Delete an existing AI Platform version. - -POSITIONAL ARGUMENTS - VERSION - Name of the model version. - -REQUIRED FLAGS - --model=MODEL - Name of the model. - -OPTIONAL FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine versions delete - - $ gcloud beta ml-engine versions delete - diff --git a/gcloud/ml-engine/versions/describe b/gcloud/ml-engine/versions/describe deleted file mode 100644 index 4a412bcf7..000000000 --- a/gcloud/ml-engine/versions/describe +++ /dev/null @@ -1,48 +0,0 @@ -NAME - gcloud ml-engine versions describe - describe an existing AI Platform - version - -SYNOPSIS - gcloud ml-engine versions describe VERSION --model=MODEL [--region=REGION] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Describe an existing AI Platform version. - -POSITIONAL ARGUMENTS - VERSION - Name of the model version. - -REQUIRED FLAGS - --model=MODEL - Name of the model. - -OPTIONAL FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine versions describe - - $ gcloud beta ml-engine versions describe - diff --git a/gcloud/ml-engine/versions/help b/gcloud/ml-engine/versions/help deleted file mode 100644 index e2a068802..000000000 --- a/gcloud/ml-engine/versions/help +++ /dev/null @@ -1,47 +0,0 @@ -NAME - gcloud ml-engine versions - AI Platform Versions commands - -SYNOPSIS - gcloud ml-engine versions COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - A version is an implementation of a model, represented as a serialized - TensorFlow graph with trained parameters. - - When you communicate with AI Platform services, you use the combination of - the model, version, and current project to identify a specific model - implementation that is deployed in the cloud. - -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 new AI Platform version. - - delete - Delete an existing AI Platform version. - - describe - Describe an existing AI Platform version. - - list - List existing AI Platform versions. - - set-default - Sets an existing AI Platform version as the default for its model. - - update - Update an AI Platform version. - -NOTES - These variants are also available: - - $ gcloud alpha ml-engine versions - - $ gcloud beta ml-engine versions - diff --git a/gcloud/ml-engine/versions/set-default b/gcloud/ml-engine/versions/set-default deleted file mode 100644 index 0de2b2da7..000000000 --- a/gcloud/ml-engine/versions/set-default +++ /dev/null @@ -1,52 +0,0 @@ -NAME - gcloud ml-engine versions set-default - sets an existing AI Platform - version as the default for its model - -SYNOPSIS - gcloud ml-engine versions set-default VERSION --model=MODEL - [--region=REGION] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Sets an existing AI Platform version as the default for its model. - - gcloud ml-engine versions set-default sets an existing AI Platform version - as the default for its model. Only one version may be the default for a - given version. - -POSITIONAL ARGUMENTS - VERSION - Name of the model version. - -REQUIRED FLAGS - --model=MODEL - Name of the model. - -OPTIONAL FLAGS - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --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 ml-engine versions set-default - - $ gcloud beta ml-engine versions set-default - diff --git a/gcloud/ml-engine/versions/update b/gcloud/ml-engine/versions/update deleted file mode 100644 index a3b0ed1be..000000000 --- a/gcloud/ml-engine/versions/update +++ /dev/null @@ -1,136 +0,0 @@ -NAME - gcloud ml-engine versions update - update an AI Platform version - -SYNOPSIS - gcloud ml-engine versions update (VERSION : --model=MODEL) - [--config=YAML_FILE] [--description=DESCRIPTION] [--region=REGION] - [--update-labels=[KEY=VALUE,...]] - [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Update an AI Platform version. - -POSITIONAL ARGUMENTS - Version resource - The AI Platform model 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 version 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. - - VERSION - ID of the version or fully qualified identifier for the version. - - To set the version attribute: - ▸ provide the argument version on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --model=MODEL - Model for the version. - - To set the model attribute: - ▸ provide the argument version on the command line with a fully - specified name; - ▸ provide the argument --model on the command line. - -FLAGS - --config=YAML_FILE - Path to a YAML configuration file containing configuration parameters - for the version - (https://cloud.google.com/ml/reference/rest/v1/projects.models.versions) - to create. - - The file is in YAML format. Note that not all attributes of a version - are configurable; available attributes (with example values) are: - - description: A free-form description of the version. - manualScaling: - nodes: 10 # The number of nodes to allocate for this model. - autoScaling: - minNodes: 0 # The minimum number of nodes to allocate for this model. - maxNodes: 1 # The maxinum number of nodes to allocate for this model. - requestLoggingconfig: - bigqueryTableName: someTable # Fully qualified BigQuery table name. - samplingPercentage: 0.5 # Percentage of requests to be logged. - - The name of the version must always be specified via the required - VERSION argument. - - Only one of manualScaling or autoScaling can be specified. If both are - specified in same yaml file, an error will be returned. - - Labels cannot currently be set in the config.yaml; please use the - command-line flags to alter them. - - If an option is specified both in the configuration file and via - command-line arguments, the command-line arguments override the - configuration file. - - --description=DESCRIPTION - Description of the version. - - --region=REGION - Google Cloud region of the regional endpoint to use for this command. - For the global endpoint, the region needs to be specified as global. - - Learn more about regional endpoints and see a list of available - regions: - https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints - - REGION must be one of: global, asia-east1, asia-northeast1, - asia-southeast1, australia-southeast1, europe-west1, europe-west2, - europe-west3, europe-west4, northamerica-northeast1, us-central1, - us-east1, us-east4, us-west1. - - --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 ml-engine versions update --clear-labels - - To remove all existing labels and create two new labels, foo and baz: - - $ gcloud ml-engine versions 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 - These variants are also available: - - $ gcloud alpha ml-engine versions update - - $ gcloud beta ml-engine versions update -