diff --git a/gcloud/_version b/gcloud/_version index 770ea4337..bc278cef2 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,6 +1,6 @@ -Google Cloud SDK 393.0.0 -alpha 2022.07.08 -beta 2022.07.08 +Google Cloud SDK 394.0.0 +alpha 2022.07.19 +beta 2022.07.19 bq 2.0.75 -core 2022.07.08 -gsutil 5.10 +core 2022.07.19 +gsutil 5.11 diff --git a/gcloud/ai/models/describe b/gcloud/ai/models/describe index 2aa28c8ab..3af81927b 100644 --- a/gcloud/ai/models/describe +++ b/gcloud/ai/models/describe @@ -11,6 +11,12 @@ EXAMPLES $ gcloud ai models describe 123 --project=example \ --region=us-central1 + Describe a model 123 of version 2 of project example in region us-central1, + run: + + $ gcloud ai models describe 123@2 --project=example \ + --region=us-central1 + POSITIONAL ARGUMENTS Model resource - Model to describe. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some attributes diff --git a/gcloud/ai/models/help b/gcloud/ai/models/help index c82fc8c65..11dd9e560 100644 --- a/gcloud/ai/models/help +++ b/gcloud/ai/models/help @@ -27,6 +27,9 @@ COMMANDS list List the models of the given project and region. + list-version + List the model versions of the given region and model. + upload Upload a new model. diff --git a/gcloud/ai/models/list-version b/gcloud/ai/models/list-version new file mode 100644 index 000000000..75755a8de --- /dev/null +++ b/gcloud/ai/models/list-version @@ -0,0 +1,91 @@ +NAME + gcloud ai models list-version - list the model versions of the given region + and model + +SYNOPSIS + gcloud ai models list-version (MODEL : --region=REGION) + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +EXAMPLES + List the model version of a model 123 of project example in region + us-central1, run: + + $ gcloud ai models list-version 123 --project=example \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Model resource - Model to list versions. The arguments in this group can + be used to specify the attributes of this resource. (NOTE) 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. + + This positional must be specified if any of the other arguments in + this group are specified. + + --region=REGION + Cloud region for the model. To set the region attribute: + ▸ provide the argument model on the command line with a fully + specified name; + ▸ provide the argument --region on the command line; + ▸ set the property ai/region; + ▸ choose one from the prompted list of available regions. + +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 ai models list-version + + $ gcloud beta ai models list-version + diff --git a/gcloud/alpha/ai/models/describe b/gcloud/alpha/ai/models/describe index f55bfe483..4525d6858 100644 --- a/gcloud/alpha/ai/models/describe +++ b/gcloud/alpha/ai/models/describe @@ -12,6 +12,12 @@ EXAMPLES $ gcloud alpha ai models describe 123 --project=example \ --region=us-central1 + Describe a model 123 of version 2 of project example in region us-central1, + run: + + $ gcloud alpha ai models describe 123@2 --project=example \ + --region=us-central1 + POSITIONAL ARGUMENTS Model resource - Model to describe. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some attributes diff --git a/gcloud/alpha/ai/models/help b/gcloud/alpha/ai/models/help index ecafd0d5f..d0034cd5f 100644 --- a/gcloud/alpha/ai/models/help +++ b/gcloud/alpha/ai/models/help @@ -27,6 +27,9 @@ COMMANDS list (ALPHA) List the models of the given project and region. + list-version + (ALPHA) List the model versions of the given region and model. + upload (ALPHA) Upload a new model. diff --git a/gcloud/alpha/ai/models/list-version b/gcloud/alpha/ai/models/list-version new file mode 100644 index 000000000..63981059d --- /dev/null +++ b/gcloud/alpha/ai/models/list-version @@ -0,0 +1,94 @@ +NAME + gcloud alpha ai models list-version - list the model versions of the given + region and model + +SYNOPSIS + gcloud alpha ai models list-version (MODEL : --region=REGION) + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +EXAMPLES + List the model version of a model 123 of project example in region + us-central1, run: + + $ gcloud alpha ai models list-version 123 --project=example \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Model resource - Model to list versions. The arguments in this group can + be used to specify the attributes of this resource. (NOTE) 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. + + This positional must be specified if any of the other arguments in + this group are specified. + + --region=REGION + Cloud region for the model. To set the region attribute: + ▸ provide the argument model on the command line with a fully + specified name; + ▸ provide the argument --region on the command line; + ▸ set the property ai/region; + ▸ choose one from the prompted list of available regions. + +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 ai models list-version + + $ gcloud beta ai models list-version + diff --git a/gcloud/alpha/batch/help b/gcloud/alpha/batch/help new file mode 100644 index 000000000..bd1b9e7c0 --- /dev/null +++ b/gcloud/alpha/batch/help @@ -0,0 +1,31 @@ +NAME + gcloud alpha batch - manage Batch resources + +SYNOPSIS + gcloud alpha batch GROUP [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Batch resources. + +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) Manage Batch job resources. + + tasks + (ALPHA) Manage Batch task resources. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta batch + diff --git a/gcloud/alpha/batch/jobs/delete b/gcloud/alpha/batch/jobs/delete new file mode 100644 index 000000000..36333b895 --- /dev/null +++ b/gcloud/alpha/batch/jobs/delete @@ -0,0 +1,61 @@ +NAME + gcloud alpha batch jobs delete - delete a job + +SYNOPSIS + gcloud alpha batch jobs delete (JOB : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) This command can fail for the following reasons: + ▪ The job specified does not exist. + ▪ The active account does not have permission to delete the given job. + +EXAMPLES + To delete the job with name projects/foo/locations/us-central1/jobs/bar, + run: + + $ gcloud alpha batch jobs delete \ + projects/foo/locations/us-central1/jobs/bar + +POSITIONAL ARGUMENTS + Job resource - The Batch job resource. The arguments in this group can be + used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. To set + the project attribute: + ◆ provide the argument JOB 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. + + JOB + ID of the job or fully qualified identifier for the job. To set the + job attribute: + ▸ provide the argument JOB on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + Google Cloud location for the job. To set the location attribute: + ▸ provide the argument JOB on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --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 batch jobs delete + diff --git a/gcloud/alpha/batch/jobs/describe b/gcloud/alpha/batch/jobs/describe new file mode 100644 index 000000000..17d0ac9e6 --- /dev/null +++ b/gcloud/alpha/batch/jobs/describe @@ -0,0 +1,61 @@ +NAME + gcloud alpha batch jobs describe - show details of a job + +SYNOPSIS + gcloud alpha batch jobs describe (JOB : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) This command can fail for the following reasons: + ▪ The job specified does not exist. + ▪ The active account does not have permission to access the given job. + +EXAMPLES + To print details of the job with name + projects/foo/locations/us-central1/jobs/bar, run: + + $ gcloud alpha batch jobs describe \ + projects/foo/locations/us-central1/jobs/bar + +POSITIONAL ARGUMENTS + Job resource - The Batch job resource. The arguments in this group can be + used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. To set + the project attribute: + ◆ provide the argument JOB 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. + + JOB + ID of the job or fully qualified identifier for the job. To set the + job attribute: + ▸ provide the argument JOB on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + Google Cloud location for the job. To set the location attribute: + ▸ provide the argument JOB on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --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 batch jobs describe + diff --git a/gcloud/alpha/batch/jobs/help b/gcloud/alpha/batch/jobs/help new file mode 100644 index 000000000..56b052c52 --- /dev/null +++ b/gcloud/alpha/batch/jobs/help @@ -0,0 +1,37 @@ +NAME + gcloud alpha batch jobs - manage Batch job resources + +SYNOPSIS + gcloud alpha batch jobs COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Batch job resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + delete + (ALPHA) Delete a job. + + describe + (ALPHA) Show details of a job. + + list + (ALPHA) List jobs for a specified Batch project/location. + + submit + (ALPHA) Submit a Batch 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. This variant is also available: + + $ gcloud beta batch jobs + diff --git a/gcloud/alpha/batch/jobs/list b/gcloud/alpha/batch/jobs/list new file mode 100644 index 000000000..e6c0824c4 --- /dev/null +++ b/gcloud/alpha/batch/jobs/list @@ -0,0 +1,78 @@ +NAME + gcloud alpha batch jobs list - list jobs for a specified Batch + project/location + +SYNOPSIS + gcloud alpha batch jobs list LOCATION [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) This command can fail for the following reasons: + ▪ The project/location specified do not exist. + ▪ The active account does not have permission to access the given + project/location. + +EXAMPLES + To print all the jobs under projects/location + projects/foo/locations/us-central1, run: + + $ gcloud alpha batch jobs list projects/foo/locations/us-central1 + +POSITIONAL ARGUMENTS + Location resource - The Batch location resource. This represents a Cloud + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. To set the project attribute: + ◆ provide the argument LOCATION on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + LOCATION + ID of the location or fully qualified identifier for the location. To + set the location attribute: + ▸ provide the argument LOCATION on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --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 batch jobs list + diff --git a/gcloud/alpha/batch/jobs/submit b/gcloud/alpha/batch/jobs/submit new file mode 100644 index 000000000..c949c11ea --- /dev/null +++ b/gcloud/alpha/batch/jobs/submit @@ -0,0 +1,131 @@ +NAME + gcloud alpha batch jobs submit - submit a Batch job + +SYNOPSIS + gcloud alpha batch jobs submit (JOB : --location=LOCATION) + (--config=CONFIG --container-commands-file=CONTAINER_COMMANDS_FILE + --container-entrypoint=CONTAINER_ENTRYPOINT + --container-image-uri=CONTAINER_IMAGE_URI + | --script-file-path=SCRIPT_FILE_PATH | --script-text=SCRIPT_TEXT) + [--machine-type=MACHINE_TYPE] [--priority=PRIORITY] + [--provisioning-model=PROVISIONING_MODEL] + [--network=NETWORK --subnetwork=SUBNETWORK] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) This command can fail for the following reasons: + ▪ The active account does not have permission to create the Batch job. + +EXAMPLES + To submit the job with config.json sample config file and name + projects/foo/locations/us-central1/jobs/bar, run: + + $ gcloud alpha batch jobs submit \ + projects/foo/locations/us-central1/jobs/bar --config=config.json + +POSITIONAL ARGUMENTS + Job resource - The Batch job resource. The arguments in this group can be + used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. To set + the project attribute: + ◆ provide the argument JOB 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. + + JOB + ID of the job or fully qualified identifier for the job. To set the + job attribute: + ▸ provide the argument JOB on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + Google Cloud location for the job. To set the location attribute: + ▸ provide the argument JOB on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + At least one of these must be specified: + + --config=CONFIG + The JSON file of the job config. + + Either specify the config file for the job or the first runnable in the + task spec. Specify either a script file or container arguments for the + first runnable in the task spec. + + At most one of these can be specified: + + Options to specify the container arguments for the first runnable in + the task spec. + + --container-commands-file=CONTAINER_COMMANDS_FILE + Overrides the CMD specified in the container. If there is an + ENTRYPOINT (either in the container image or with the entrypoint + field below) then commands are appended as arguments to the + ENTRYPOINT. + + --container-entrypoint=CONTAINER_ENTRYPOINT + Overrides the ENTRYPOINT specified in the container. + + --container-image-uri=CONTAINER_IMAGE_URI + The URI to pull the container image from. + + Either specify a path to a script file to run or provide inline text + to execute directly. + + At most one of these can be specified: + + --script-file-path=SCRIPT_FILE_PATH + Path to script file to run as first runnable in task spec. File + path should be a valid path on the instance volume. + + --script-text=SCRIPT_TEXT + Text to run as first runnable in task spec. + +OPTIONAL FLAGS + --machine-type=MACHINE_TYPE + Specify the Compute Engine machine type, for example, e2-standard-4. + Currently only one machine type is supported. + + --priority=PRIORITY + Job priority [0-99] 0 is the lowest priority. + + --provisioning-model=PROVISIONING_MODEL + Specify the allowed provisioning model for the compute instances. + PROVISIONING_MODEL must be one of: + + SPOT + The SPOT VM provisioning model. Ideal for fault-tolerant workloads + that can withstand preemption. + STANDARD + The STANDARD VM provisioning model + + --network=NETWORK + The URL for the network resource. Must specify subnetwork as well if + network is specified + + --subnetwork=SUBNETWORK + The URL for the subnetwork resource. Must specify network as well if + subnetwork is 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. This variant is also available: + + $ gcloud beta batch jobs submit + diff --git a/gcloud/alpha/batch/tasks/describe b/gcloud/alpha/batch/tasks/describe new file mode 100644 index 000000000..2bc05f1de --- /dev/null +++ b/gcloud/alpha/batch/tasks/describe @@ -0,0 +1,75 @@ +NAME + gcloud alpha batch tasks describe - show details of a task + +SYNOPSIS + gcloud alpha batch tasks describe + (TASK : --job=JOB --location=LOCATION --task_group=TASK_GROUP) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) This command can fail for the following reasons: + ▪ The task specified does not exist. + ▪ The active account does not have permission to access the given task. + +EXAMPLES + To print details of the task with name + projects/foo/locations/us-central1/jobs/bar/taskGroups/group0/tasks/0, run: + + $ gcloud alpha batch tasks describe \ + projects/foo/locations/us-central1/jobs/bar/taskGroups/group0/\ + tasks/0 + +POSITIONAL ARGUMENTS + Task resource - The Batch task resource. The arguments in this group can + be used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. To set + the project attribute: + ◆ provide the argument TASK 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. + + TASK + ID of the task or fully qualified identifier for the task. To set the + task attribute: + ▸ provide the argument TASK on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --job=JOB + The job ID for the task. To set the job attribute: + ▸ provide the argument TASK on the command line with a fully + specified name; + ▸ provide the argument --job on the command line. + + --location=LOCATION + Google Cloud location for the task. To set the location attribute: + ▸ provide the argument TASK on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --task_group=TASK_GROUP + The task_group ID for the task. To set the task_group attribute: + ▸ provide the argument TASK on the command line with a fully + specified name; + ▸ provide the argument --task_group on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails 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 batch tasks describe + diff --git a/gcloud/alpha/batch/tasks/help b/gcloud/alpha/batch/tasks/help new file mode 100644 index 000000000..8253e670e --- /dev/null +++ b/gcloud/alpha/batch/tasks/help @@ -0,0 +1,31 @@ +NAME + gcloud alpha batch tasks - manage Batch task resources + +SYNOPSIS + gcloud alpha batch tasks COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Batch task resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + (ALPHA) Show details of a task. + + list + (ALPHA) List tasks for a specified Batch task_group. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails 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 batch tasks + diff --git a/gcloud/alpha/batch/tasks/list b/gcloud/alpha/batch/tasks/list new file mode 100644 index 000000000..6fc457c5d --- /dev/null +++ b/gcloud/alpha/batch/tasks/list @@ -0,0 +1,96 @@ +NAME + gcloud alpha batch tasks list - list tasks for a specified Batch task_group + +SYNOPSIS + gcloud alpha batch tasks list (TASK_GROUP : --job=JOB --location=LOCATION) + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) This command can fail for the following reasons: + ▪ The task_group specified does not exist. + ▪ The active account does not have permission to access the given + task_group. + +EXAMPLES + To print all tasks under the task_group with name + projects/foo/locations/us-central1/jobs/bar/taskGroups/group0, run: + + $ gcloud alpha batch tasks list \ + projects/foo/locations/us-central1/jobs/bar/taskGroups/group0 + +POSITIONAL ARGUMENTS + Task group resource - The Batch task_group resource. The arguments in this + group can be used to specify the attributes of this resource. (NOTE) Some + attributes are not given arguments in this group but can be set in other + ways. To set the project attribute: + ◆ provide the argument TASK_GROUP on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + TASK_GROUP + ID of the task_group or fully qualified identifier for the + task_group. To set the task_group attribute: + ▸ provide the argument TASK_GROUP on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --job=JOB + The job ID for the task_group. To set the job attribute: + ▸ provide the argument TASK_GROUP on the command line with a fully + specified name; + ▸ provide the argument --job on the command line. + + --location=LOCATION + Google Cloud location for the task_group. To set the location + attribute: + ▸ provide the argument TASK_GROUP on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --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 batch tasks list + diff --git a/gcloud/alpha/bms/networks/list-ip-reservations b/gcloud/alpha/bms/networks/list-ip-reservations index 908a7c195..6d2525b5a 100644 --- a/gcloud/alpha/bms/networks/list-ip-reservations +++ b/gcloud/alpha/bms/networks/list-ip-reservations @@ -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 bms networks list-ip-reservations diff --git a/gcloud/alpha/compute/addresses/help b/gcloud/alpha/compute/addresses/help index 0f4350013..1b9b75d6c 100644 --- a/gcloud/alpha/compute/addresses/help +++ b/gcloud/alpha/compute/addresses/help @@ -40,6 +40,9 @@ COMMANDS list (ALPHA) List addresses. + move + (ALPHA) Move an address to another project. + update (ALPHA) Update a Compute Engine address. diff --git a/gcloud/alpha/compute/addresses/move b/gcloud/alpha/compute/addresses/move new file mode 100644 index 000000000..356a67f4f --- /dev/null +++ b/gcloud/alpha/compute/addresses/move @@ -0,0 +1,51 @@ +NAME + gcloud alpha compute addresses move - move an address to another project + +SYNOPSIS + gcloud alpha compute addresses move NAME --target-project=TARGET_PROJECT + [--description=DESCRIPTION] [--new-name=NEW_NAME] + [--global | --region=REGION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Move an address to another project. + +POSITIONAL ARGUMENTS + NAME + Name of the address to operate on. + +REQUIRED FLAGS + --target-project=TARGET_PROJECT + The target project to move address in. It can be either project name or + project numerical ID. It must not be the same as the current project. + +OPTIONAL FLAGS + --description=DESCRIPTION + Description of moved new address. + + --new-name=NEW_NAME + Name of moved new address. If not specified, current address's name is + used. + + At most one of these can be specified: + + --global + If set, the address is global. + + --region=REGION + Region of the address to operate on. Overrides the default + compute/region property value for this command invocation. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/compute/disks/create b/gcloud/alpha/compute/disks/create index 3376a365d..3659a7240 100644 --- a/gcloud/alpha/compute/disks/create +++ b/gcloud/alpha/compute/disks/create @@ -149,11 +149,10 @@ FLAGS Size of the disks. The value must be a whole number followed by a size unit of GB for gigabyte, or TB for terabyte. If no size unit is specified, GB is assumed. For example, 10GB will produce 10 gigabyte - disks. Disk size must be a multiple of 1 GB. Limit your boot disk size - to 2TB to account for MBR partition table limitations. If disk size is - not specified, the default size of 500GB for pd-standard disks, 100GB - for pd-balanced disks, 100GB for pd-ssd disks, and 1000GB for - pd-extreme will be used. For details about disk size limits, refer to: + disks. Disk size must be a multiple of 1 GB. If disk size is not + specified, the default size of 500GB for pd-standard disks, 100GB for + pd-balanced disks, 100GB for pd-ssd disks, and 1000GB for pd-extreme + will be used. For details about disk size limits, refer to: https://cloud.google.com/compute/docs/disks --type=TYPE diff --git a/gcloud/alpha/compute/instance-groups/managed/create b/gcloud/alpha/compute/instance-groups/managed/create index e87165763..d89f1c4c0 100644 --- a/gcloud/alpha/compute/instance-groups/managed/create +++ b/gcloud/alpha/compute/instance-groups/managed/create @@ -190,6 +190,13 @@ OPTIONAL FLAGS requested number of VMs within present resource constraints and to maximize utilization of unused zonal reservations. Recommended for batch workloads that do not require high availability. + any-single-zone + The group schedules all instances within a single zone. The zone is + chosen based on hardware support, current resources availability, + and matching reservations. The group might not be able to create + the requested number of VMs in case of zonal resource availability + constraints. Recommended for workloads requiring extensive + communication between VMs. balanced The group prioritizes acquisition of resources, scheduling VMs in zones where resources are available while distributing VMs as diff --git a/gcloud/alpha/compute/instance-groups/managed/update b/gcloud/alpha/compute/instance-groups/managed/update index 7d5c6a3b5..5f883244e 100644 --- a/gcloud/alpha/compute/instance-groups/managed/update +++ b/gcloud/alpha/compute/instance-groups/managed/update @@ -207,6 +207,13 @@ FLAGS requested number of VMs within present resource constraints and to maximize utilization of unused zonal reservations. Recommended for batch workloads that do not require high availability. + any-single-zone + The group schedules all instances within a single zone. The zone is + chosen based on hardware support, current resources availability, + and matching reservations. The group might not be able to create + the requested number of VMs in case of zonal resource availability + constraints. Recommended for workloads requiring extensive + communication between VMs. balanced The group prioritizes acquisition of resources, scheduling VMs in zones where resources are available while distributing VMs as diff --git a/gcloud/alpha/compute/security-policies/update b/gcloud/alpha/compute/security-policies/update index 2e0a229be..d4d3577d4 100644 --- a/gcloud/alpha/compute/security-policies/update +++ b/gcloud/alpha/compute/security-policies/update @@ -7,6 +7,10 @@ SYNOPSIS [--ddos-protection=DDOS_PROTECTION] [--description=DESCRIPTION] [--enable-layer7-ddos-defense] [--enable-ml] [--json-parsing=JSON_PARSING] + [--layer7-ddos-defense-auto-deploy-confidence-threshold=LAYER7_DDOS_DEFENSE_AUTO_DEPLOY_CONFIDENCE_THRESHOLD] + [--layer7-ddos-defense-auto-deploy-expiration-sec=LAYER7_DDOS_DEFENSE_AUTO_DEPLOY_EXPIRATION_SEC] + [--layer7-ddos-defense-auto-deploy-impacted-baseline-threshold=LAYER7_DDOS_DEFENSE_AUTO_DEPLOY_IMPACTED_BASELINE_THRESHOLD] + [--layer7-ddos-defense-auto-deploy-load-threshold=LAYER7_DDOS_DEFENSE_AUTO_DEPLOY_LOAD_THRESHOLD] [--layer7-ddos-defense-rule-visibility=VISIBILITY_TYPE] [--log-level=LOG_LEVEL] [--network-ddos-protection=NETWORK_DDOS_PROTECTION] @@ -46,6 +50,21 @@ FLAGS values: [DISABLED, STANDARD]. JSON_PARSING must be one of: DISABLED, STANDARD. + --layer7-ddos-defense-auto-deploy-confidence-threshold=LAYER7_DDOS_DEFENSE_AUTO_DEPLOY_CONFIDENCE_THRESHOLD + Confidence threshold above which Adaptive Protection's auto-deploy + takes actions + + --layer7-ddos-defense-auto-deploy-expiration-sec=LAYER7_DDOS_DEFENSE_AUTO_DEPLOY_EXPIRATION_SEC + Duration over which Adaptive Protection's auto-deployed actions last + + --layer7-ddos-defense-auto-deploy-impacted-baseline-threshold=LAYER7_DDOS_DEFENSE_AUTO_DEPLOY_IMPACTED_BASELINE_THRESHOLD + Impacted baseline threshold below which Adaptive Protection's + auto-deploy takes actions + + --layer7-ddos-defense-auto-deploy-load-threshold=LAYER7_DDOS_DEFENSE_AUTO_DEPLOY_LOAD_THRESHOLD + Load threshold above which Adaptive Protection's auto-deploy takes + actions + --layer7-ddos-defense-rule-visibility=VISIBILITY_TYPE The visibility type indicates whether the rules are opaque or transparent. VISIBILITY_TYPE must be one of: STANDARD, PREMIUM. diff --git a/gcloud/alpha/container/azure/node-pools/update b/gcloud/alpha/container/azure/node-pools/update index cc9ea23ca..5ebdaf67f 100644 --- a/gcloud/alpha/container/azure/node-pools/update +++ b/gcloud/alpha/container/azure/node-pools/update @@ -5,8 +5,9 @@ NAME SYNOPSIS gcloud alpha container azure node-pools update (NODE_POOL : --cluster=CLUSTER --location=LOCATION) [--async] - [--node-version=NODE_VERSION] [--validate-only] - [--max-nodes=MAX_NODES --min-nodes=MIN_NODES] [GCLOUD_WIDE_FLAG ...] + [--node-version=NODE_VERSION] [--ssh-public-key=SSH_PUBLIC_KEY] + [--validate-only] [--max-nodes=MAX_NODES --min-nodes=MIN_NODES] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Update a node pool in an Anthos cluster on Azure. @@ -62,6 +63,9 @@ FLAGS --node-version=NODE_VERSION Kubernetes version to use for the node pool. + --ssh-public-key=SSH_PUBLIC_KEY + SSH public key to use for authentication. + --validate-only Validate the update of the node pool, but don't actually perform it. diff --git a/gcloud/alpha/container/fleet/memberships/register b/gcloud/alpha/container/fleet/memberships/register index d8e974b34..d91e6f73c 100644 --- a/gcloud/alpha/container/fleet/memberships/register +++ b/gcloud/alpha/container/fleet/memberships/register @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud alpha container fleet memberships register - [[MEMBERSHIP_NAME] --location=LOCATION] + (MEMBERSHIP_NAME : --location=LOCATION) (--gke-cluster=LOCATION/CLUSTER_NAME | --gke-uri=GKE_URI | [--context=CONTEXT : --kubeconfig=KUBECONFIG]) (--service-account-key-file=SERVICE_ACCOUNT_KEY_FILE @@ -118,22 +118,25 @@ EXAMPLES --service-account-key-file=/tmp/keyfile.json POSITIONAL ARGUMENTS - Membership resource - Membership resource name. The arguments in this - group can be used to specify the attributes of this resource. (NOTE) Some - attributes are not given arguments in this group but can be set in other - ways. To set the project attribute: + Membership resource - The group of arguments defining a membership + resource. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. To set the project + attribute: ◆ provide the argument MEMBERSHIP_NAME on the command line with a fully specified name; - ◆ provide the argument --membership on the command line with a fully - specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. - [MEMBERSHIP_NAME] + This must be specified. + + MEMBERSHIP_NAME ID of the membership or fully qualified identifier for the membership. To set the membership attribute: - ▸ provide the argument MEMBERSHIP_NAME on the command line; - ▸ provide the argument --membership on the command line. + ▸ provide the argument MEMBERSHIP_NAME on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. --location=LOCATION The location for the membership resource, e.g. us-central1. If not @@ -143,8 +146,6 @@ POSITIONAL ARGUMENTS To set the location attribute: ▸ provide the argument MEMBERSHIP_NAME on the command line with a fully specified name; - ▸ provide the argument --membership on the command line with a - fully specified name; ▸ provide the argument --location on the command line; ▸ set the property gkehub/location. diff --git a/gcloud/alpha/container/fleet/memberships/unregister b/gcloud/alpha/container/fleet/memberships/unregister index 6e813bbbe..c6eec0d8b 100644 --- a/gcloud/alpha/container/fleet/memberships/unregister +++ b/gcloud/alpha/container/fleet/memberships/unregister @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud alpha container fleet memberships unregister - [[MEMBERSHIP_NAME] --location=LOCATION] + (MEMBERSHIP_NAME : --location=LOCATION) (--gke-cluster=LOCATION/CLUSTER_NAME | --gke-uri=GKE_URI | [--context=CONTEXT : --kubeconfig=KUBECONFIG]) [GCLOUD_WIDE_FLAG ...] @@ -59,22 +59,25 @@ EXAMPLES my-membership --gke-cluster=my-cluster-region-or-zone/my-cluster POSITIONAL ARGUMENTS - Membership resource - Membership resource name. The arguments in this - group can be used to specify the attributes of this resource. (NOTE) Some - attributes are not given arguments in this group but can be set in other - ways. To set the project attribute: + Membership resource - The group of arguments defining a membership + resource. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. To set the project + attribute: ◆ provide the argument MEMBERSHIP_NAME on the command line with a fully specified name; - ◆ provide the argument --membership on the command line with a fully - specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. - [MEMBERSHIP_NAME] + This must be specified. + + MEMBERSHIP_NAME ID of the membership or fully qualified identifier for the membership. To set the membership attribute: - ▸ provide the argument MEMBERSHIP_NAME on the command line; - ▸ provide the argument --membership on the command line. + ▸ provide the argument MEMBERSHIP_NAME on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. --location=LOCATION The location of the membership resource, e.g. us-central1. If not @@ -83,8 +86,6 @@ POSITIONAL ARGUMENTS To set the location attribute: ▸ provide the argument MEMBERSHIP_NAME on the command line with a fully specified name; - ▸ provide the argument --membership on the command line with a - fully specified name; ▸ provide the argument --location on the command line; ▸ set the property gkehub/location. diff --git a/gcloud/alpha/container/hub/memberships/register b/gcloud/alpha/container/hub/memberships/register index 4dcc47023..ddf88edae 100644 --- a/gcloud/alpha/container/hub/memberships/register +++ b/gcloud/alpha/container/hub/memberships/register @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud alpha container hub memberships register - [[MEMBERSHIP_NAME] --location=LOCATION] + (MEMBERSHIP_NAME : --location=LOCATION) (--gke-cluster=LOCATION/CLUSTER_NAME | --gke-uri=GKE_URI | [--context=CONTEXT : --kubeconfig=KUBECONFIG]) (--service-account-key-file=SERVICE_ACCOUNT_KEY_FILE @@ -118,22 +118,25 @@ EXAMPLES --service-account-key-file=/tmp/keyfile.json POSITIONAL ARGUMENTS - Membership resource - Membership resource name. The arguments in this - group can be used to specify the attributes of this resource. (NOTE) Some - attributes are not given arguments in this group but can be set in other - ways. To set the project attribute: + Membership resource - The group of arguments defining a membership + resource. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. To set the project + attribute: ◆ provide the argument MEMBERSHIP_NAME on the command line with a fully specified name; - ◆ provide the argument --membership on the command line with a fully - specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. - [MEMBERSHIP_NAME] + This must be specified. + + MEMBERSHIP_NAME ID of the membership or fully qualified identifier for the membership. To set the membership attribute: - ▸ provide the argument MEMBERSHIP_NAME on the command line; - ▸ provide the argument --membership on the command line. + ▸ provide the argument MEMBERSHIP_NAME on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. --location=LOCATION The location for the membership resource, e.g. us-central1. If not @@ -143,8 +146,6 @@ POSITIONAL ARGUMENTS To set the location attribute: ▸ provide the argument MEMBERSHIP_NAME on the command line with a fully specified name; - ▸ provide the argument --membership on the command line with a - fully specified name; ▸ provide the argument --location on the command line; ▸ set the property gkehub/location. diff --git a/gcloud/alpha/container/hub/memberships/unregister b/gcloud/alpha/container/hub/memberships/unregister index e8b214142..ae081dca2 100644 --- a/gcloud/alpha/container/hub/memberships/unregister +++ b/gcloud/alpha/container/hub/memberships/unregister @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud alpha container hub memberships unregister - [[MEMBERSHIP_NAME] --location=LOCATION] + (MEMBERSHIP_NAME : --location=LOCATION) (--gke-cluster=LOCATION/CLUSTER_NAME | --gke-uri=GKE_URI | [--context=CONTEXT : --kubeconfig=KUBECONFIG]) [GCLOUD_WIDE_FLAG ...] @@ -59,22 +59,25 @@ EXAMPLES --gke-cluster=my-cluster-region-or-zone/my-cluster POSITIONAL ARGUMENTS - Membership resource - Membership resource name. The arguments in this - group can be used to specify the attributes of this resource. (NOTE) Some - attributes are not given arguments in this group but can be set in other - ways. To set the project attribute: + Membership resource - The group of arguments defining a membership + resource. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. To set the project + attribute: ◆ provide the argument MEMBERSHIP_NAME on the command line with a fully specified name; - ◆ provide the argument --membership on the command line with a fully - specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. - [MEMBERSHIP_NAME] + This must be specified. + + MEMBERSHIP_NAME ID of the membership or fully qualified identifier for the membership. To set the membership attribute: - ▸ provide the argument MEMBERSHIP_NAME on the command line; - ▸ provide the argument --membership on the command line. + ▸ provide the argument MEMBERSHIP_NAME on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. --location=LOCATION The location of the membership resource, e.g. us-central1. If not @@ -83,8 +86,6 @@ POSITIONAL ARGUMENTS To set the location attribute: ▸ provide the argument MEMBERSHIP_NAME on the command line with a fully specified name; - ▸ provide the argument --membership on the command line with a - fully specified name; ▸ provide the argument --location on the command line; ▸ set the property gkehub/location. diff --git a/gcloud/alpha/deploy/releases/create b/gcloud/alpha/deploy/releases/create index a39831b03..9dd68c68c 100644 --- a/gcloud/alpha/deploy/releases/create +++ b/gcloud/alpha/deploy/releases/create @@ -11,6 +11,7 @@ SYNOPSIS [--skaffold-file=SKAFFOLD_FILE] [--skaffold-version=SKAFFOLD_VERSION] [--source=SOURCE; default="."] [--to-target=TO_TARGET] [--build-artifacts=BUILD_ARTIFACTS | --images=[NAME=TAG,...]] + [--disable-initial-rollout | --enable-initial-rollout] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -101,7 +102,7 @@ FLAGS A directory in Google Cloud Storage to copy the source used for staging the build. If the specified bucket does not exist, Cloud Deploy will create one. If you don't set this field, - gs://[PROJECT_ID]_clouddeploy/source is used. + gs://[DELIVERY_PIPELINE_ID]_clouddeploy/source is used. --ignore-file=IGNORE_FILE Override the .gcloudignore file and use the specified file instead. @@ -165,6 +166,16 @@ FLAGS $ gcloud deploy releases create foo \ --images image1=path/to/image1:v1@sha256:45db24 + At most one of these can be specified: + + --disable-initial-rollout + Skips creating a rollout in the first target defined in the delivery + pipeline. + + --enable-initial-rollout + Creates a rollout in the first target defined in the delivery + pipeline. This is the default behavior. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/iam/policies/delete b/gcloud/alpha/iam/policies/delete index a38e6db78..4bc6204e2 100644 --- a/gcloud/alpha/iam/policies/delete +++ b/gcloud/alpha/iam/policies/delete @@ -34,7 +34,7 @@ REQUIRED FLAGS OPTIONAL FLAGS --etag=ETAG Etag that identifies the version of the existing policy. If omitted, - the command gets the etag for the current version of the policy. + the policy is deleted regardless of its current etag. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/iam/policies/update b/gcloud/alpha/iam/policies/update index 5724bbcf5..f02c1186c 100644 --- a/gcloud/alpha/iam/policies/update +++ b/gcloud/alpha/iam/policies/update @@ -5,7 +5,7 @@ NAME SYNOPSIS gcloud alpha iam policies update POLICY_ID --attachment-point=ATTACHMENT_POINT --kind=KIND - --policy-file=POLICY_FILE [--etag=ETAG] [GCLOUD_WIDE_FLAG ...] + --policy-file=POLICY_FILE [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Update the policy on the given attachment point with the given @@ -13,12 +13,11 @@ DESCRIPTION EXAMPLES The following command updates the IAM policy defined at the resource - project 123 of kind denypolicies and id my-deny-policy, with etag abc: + project 123 of kind denypolicies and id my-deny-policy: $ gcloud alpha iam policies update my-deny-policy \ --attachment-point=cloudresourcemanager.googleapis.com/\ - projects/123 --kind=denypolicies --policy-file=policy.json \ - --etag=abc + projects/123 --kind=denypolicies --policy-file=policy.json POSITIONAL ARGUMENTS POLICY_ID @@ -37,11 +36,6 @@ REQUIRED FLAGS Path to the file that contains the policy, in JSON or YAML format. For valid syntax, see https://cloud.google.com/iam/help/deny/policy-syntax. -OPTIONAL FLAGS - --etag=ETAG - Etag that identifies the version of the existing policy. If omitted, - the command gets the etag for the current version of the policy. - GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/kms/import-jobs/create b/gcloud/alpha/kms/import-jobs/create index 96c48ef4e..0a6536a29 100644 --- a/gcloud/alpha/kms/import-jobs/create +++ b/gcloud/alpha/kms/import-jobs/create @@ -15,7 +15,7 @@ EXAMPLES $ gcloud alpha kms import-jobs create strider \ --location=us-central1 --keyring=fellowship \ - --import-method=rsa-oaep-3072-sha1-aes-256 \ + --import-method=rsa-oaep-3072-sha256-aes-256 \ --protection-level=hsm POSITIONAL ARGUMENTS diff --git a/gcloud/alpha/scc/settings/services/describe b/gcloud/alpha/scc/settings/services/describe index 8eaea7b12..13be76da4 100644 --- a/gcloud/alpha/scc/settings/services/describe +++ b/gcloud/alpha/scc/settings/services/describe @@ -21,8 +21,8 @@ REQUIRED FLAGS --service=SERVICE_NAME Service name in Security Command Center. SERVICE_NAME must be one of: container-threat-detection, event-threat-detection, - security-health-analytics, virtual-machine-threat-detection, - web-security-scanner. + rapid-vulnerability-detection, security-health-analytics, + virtual-machine-threat-detection, web-security-scanner. OPTIONAL FLAGS At most one of these can be specified: diff --git a/gcloud/alpha/scc/settings/services/describe-explicit b/gcloud/alpha/scc/settings/services/describe-explicit index 5064b27b4..eb51421c9 100644 --- a/gcloud/alpha/scc/settings/services/describe-explicit +++ b/gcloud/alpha/scc/settings/services/describe-explicit @@ -20,8 +20,8 @@ REQUIRED FLAGS --service=SERVICE_NAME Service name in Security Command Center. SERVICE_NAME must be one of: container-threat-detection, event-threat-detection, - security-health-analytics, virtual-machine-threat-detection, - web-security-scanner. + rapid-vulnerability-detection, security-health-analytics, + virtual-machine-threat-detection, web-security-scanner. OPTIONAL FLAGS At most one of these can be specified: diff --git a/gcloud/alpha/scc/settings/services/disable b/gcloud/alpha/scc/settings/services/disable index 0d1b950e2..25edcc52a 100644 --- a/gcloud/alpha/scc/settings/services/disable +++ b/gcloud/alpha/scc/settings/services/disable @@ -20,8 +20,8 @@ REQUIRED FLAGS --service=SERVICE_NAME Service name in Security Command Center. SERVICE_NAME must be one of: container-threat-detection, event-threat-detection, - security-health-analytics, virtual-machine-threat-detection, - web-security-scanner. + rapid-vulnerability-detection, security-health-analytics, + virtual-machine-threat-detection, web-security-scanner. OPTIONAL FLAGS At most one of these can be specified: diff --git a/gcloud/alpha/scc/settings/services/enable b/gcloud/alpha/scc/settings/services/enable index 21256c483..1e758cc6e 100644 --- a/gcloud/alpha/scc/settings/services/enable +++ b/gcloud/alpha/scc/settings/services/enable @@ -20,8 +20,8 @@ REQUIRED FLAGS --service=SERVICE_NAME Service name in Security Command Center. SERVICE_NAME must be one of: container-threat-detection, event-threat-detection, - security-health-analytics, virtual-machine-threat-detection, - web-security-scanner. + rapid-vulnerability-detection, security-health-analytics, + virtual-machine-threat-detection, web-security-scanner. OPTIONAL FLAGS At most one of these can be specified: diff --git a/gcloud/alpha/scc/settings/services/inherit b/gcloud/alpha/scc/settings/services/inherit index c5a40053b..55b059556 100644 --- a/gcloud/alpha/scc/settings/services/inherit +++ b/gcloud/alpha/scc/settings/services/inherit @@ -21,8 +21,8 @@ REQUIRED FLAGS --service=SERVICE_NAME Service name in Security Command Center. SERVICE_NAME must be one of: container-threat-detection, event-threat-detection, - security-health-analytics, virtual-machine-threat-detection, - web-security-scanner. + rapid-vulnerability-detection, security-health-analytics, + virtual-machine-threat-detection, web-security-scanner. OPTIONAL FLAGS At most one of these can be specified: diff --git a/gcloud/alpha/scc/settings/services/modules/describe b/gcloud/alpha/scc/settings/services/modules/describe index 3c7c8306f..4a520f9f6 100644 --- a/gcloud/alpha/scc/settings/services/modules/describe +++ b/gcloud/alpha/scc/settings/services/modules/describe @@ -26,8 +26,8 @@ REQUIRED FLAGS --service=SERVICE_NAME Service name in Security Command Center. SERVICE_NAME must be one of: container-threat-detection, event-threat-detection, - security-health-analytics, virtual-machine-threat-detection, - web-security-scanner. + rapid-vulnerability-detection, security-health-analytics, + virtual-machine-threat-detection, web-security-scanner. OPTIONAL FLAGS At most one of these can be specified: diff --git a/gcloud/alpha/scc/settings/services/modules/describe-explicit b/gcloud/alpha/scc/settings/services/modules/describe-explicit index d8380f8a3..1d2d6e384 100644 --- a/gcloud/alpha/scc/settings/services/modules/describe-explicit +++ b/gcloud/alpha/scc/settings/services/modules/describe-explicit @@ -26,8 +26,8 @@ REQUIRED FLAGS --service=SERVICE_NAME Service name in Security Command Center. SERVICE_NAME must be one of: container-threat-detection, event-threat-detection, - security-health-analytics, virtual-machine-threat-detection, - web-security-scanner. + rapid-vulnerability-detection, security-health-analytics, + virtual-machine-threat-detection, web-security-scanner. OPTIONAL FLAGS At most one of these can be specified: diff --git a/gcloud/alpha/scc/settings/services/modules/disable b/gcloud/alpha/scc/settings/services/modules/disable index dcd7de1d8..3c787c6a4 100644 --- a/gcloud/alpha/scc/settings/services/modules/disable +++ b/gcloud/alpha/scc/settings/services/modules/disable @@ -26,8 +26,8 @@ REQUIRED FLAGS --service=SERVICE_NAME Service name in Security Command Center. SERVICE_NAME must be one of: container-threat-detection, event-threat-detection, - security-health-analytics, virtual-machine-threat-detection, - web-security-scanner. + rapid-vulnerability-detection, security-health-analytics, + virtual-machine-threat-detection, web-security-scanner. OPTIONAL FLAGS At most one of these can be specified: diff --git a/gcloud/alpha/scc/settings/services/modules/enable b/gcloud/alpha/scc/settings/services/modules/enable index 2f18d48e8..7ac54ebde 100644 --- a/gcloud/alpha/scc/settings/services/modules/enable +++ b/gcloud/alpha/scc/settings/services/modules/enable @@ -26,8 +26,8 @@ REQUIRED FLAGS --service=SERVICE_NAME Service name in Security Command Center. SERVICE_NAME must be one of: container-threat-detection, event-threat-detection, - security-health-analytics, virtual-machine-threat-detection, - web-security-scanner. + rapid-vulnerability-detection, security-health-analytics, + virtual-machine-threat-detection, web-security-scanner. OPTIONAL FLAGS At most one of these can be specified: diff --git a/gcloud/alpha/scc/settings/services/modules/update b/gcloud/alpha/scc/settings/services/modules/update index 6bac986db..8ead4f703 100644 --- a/gcloud/alpha/scc/settings/services/modules/update +++ b/gcloud/alpha/scc/settings/services/modules/update @@ -52,8 +52,8 @@ REQUIRED FLAGS --service=SERVICE_NAME Service name in Security Command Center. SERVICE_NAME must be one of: container-threat-detection, event-threat-detection, - security-health-analytics, virtual-machine-threat-detection, - web-security-scanner. + rapid-vulnerability-detection, security-health-analytics, + virtual-machine-threat-detection, web-security-scanner. OPTIONAL FLAGS Config value group in Security Command Center. diff --git a/gcloud/alpha/sql/instances/create b/gcloud/alpha/sql/instances/create index d89fbfec2..313bc78df 100644 --- a/gcloud/alpha/sql/instances/create +++ b/gcloud/alpha/sql/instances/create @@ -40,7 +40,7 @@ SYNOPSIS [--replica-type=REPLICA_TYPE] [--replication=REPLICATION] [--require-ssl] [--retained-backups-count=RETAINED_BACKUPS_COUNT] [--retained-transaction-log-days=RETAINED_TRANSACTION_LOG_DAYS] - [--root-password=ROOT_PASSWORD] [--storage-auto-increase] + [--root-password=ROOT_PASSWORD] [--[no-]storage-auto-increase] [--storage-auto-increase-limit=STORAGE_AUTO_INCREASE_LIMIT] [--storage-size=STORAGE_SIZE] [--storage-type=STORAGE_TYPE] [--tier=TIER, -t TIER] @@ -341,13 +341,15 @@ FLAGS --root-password=ROOT_PASSWORD Root Cloud SQL user's password. - --storage-auto-increase + --[no-]storage-auto-increase Storage size can be increased, but it cannot be decreased; storage increases are permanent for the life of the instance. With this setting enabled, a spike in storage requirements can result in permanently increased storage costs for your instance. However, if an instance runs out of available space, it can result in the instance going offline, - dropping existing connections. This setting is enabled by default. + dropping existing connections. This setting is enabled by default. Use + --storage-auto-increase to enable and --no-storage-auto-increase to + disable. --storage-auto-increase-limit=STORAGE_AUTO_INCREASE_LIMIT Allows you to set a maximum storage capacity, in GB. Automatic diff --git a/gcloud/alpha/sql/instances/patch b/gcloud/alpha/sql/instances/patch index e9810378d..ee9481fe4 100644 --- a/gcloud/alpha/sql/instances/patch +++ b/gcloud/alpha/sql/instances/patch @@ -35,7 +35,7 @@ SYNOPSIS [--password-policy-reuse-interval=PASSWORD_POLICY_REUSE_INTERVAL] [--pricing-plan=PRICING_PLAN, -p PRICING_PLAN] [--remove-deny-maintenance-period] [--replication=REPLICATION] - [--[no-]require-ssl] [--storage-auto-increase] + [--[no-]require-ssl] [--[no-]storage-auto-increase] [--storage-auto-increase-limit=STORAGE_AUTO_INCREASE_LIMIT] [--storage-size=STORAGE_SIZE] [--tier=TIER, -t TIER] [--update-labels=[KEY=VALUE,...]] @@ -278,13 +278,15 @@ FLAGS mysqld should default to 'REQUIRE X509' for users connecting over IP. Use --require-ssl to enable and --no-require-ssl to disable. - --storage-auto-increase + --[no-]storage-auto-increase Storage size can be increased, but it cannot be decreased; storage increases are permanent for the life of the instance. With this setting enabled, a spike in storage requirements can result in permanently increased storage costs for your instance. However, if an instance runs out of available space, it can result in the instance going offline, - dropping existing connections. This setting is enabled by default. + dropping existing connections. This setting is enabled by default. Use + --storage-auto-increase to enable and --no-storage-auto-increase to + disable. --storage-auto-increase-limit=STORAGE_AUTO_INCREASE_LIMIT Allows you to set a maximum storage capacity, in GB. Automatic diff --git a/gcloud/alpha/storage/ls b/gcloud/alpha/storage/ls index 620ff0a04..434e9452f 100644 --- a/gcloud/alpha/storage/ls +++ b/gcloud/alpha/storage/ls @@ -3,7 +3,7 @@ NAME SYNOPSIS gcloud alpha storage ls [PATH ...] [--all-versions, -a] [--buckets, -b] - [--etag, -e] [--readable-sizes] [--recursive, -R, -r] + [--etag, -e] [--format=FORMAT] [--readable-sizes] [--recursive, -R, -r] [--full, -L | --json, -j | --long, -l] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -83,6 +83,11 @@ FLAGS --etag, -e Include ETag metadata in listings that use the --long flag. + --format=FORMAT + Use "gsutil" to get the style of the older gsutil CLI. (e.g. + "--format=gsutil"). Other format values (e.g. "json") do not work. See + different ls flags and commands for alternative formatting. + --readable-sizes When used with --long, print object sizes in human readable format, such as 1 KiB, 234 MiB, or 2 GiB. diff --git a/gcloud/asset/analyze-iam-policy b/gcloud/asset/analyze-iam-policy index f729d6e81..e2698ab32 100644 --- a/gcloud/asset/analyze-iam-policy +++ b/gcloud/asset/analyze-iam-policy @@ -131,9 +131,3 @@ GCLOUD WIDE FLAGS --trace-token, --user-output-enabled, --verbosity. Run $ gcloud help for details. - -NOTES - This variant is also available: - - $ gcloud beta asset analyze-iam-policy - diff --git a/gcloud/beta/ai/models/describe b/gcloud/beta/ai/models/describe index aa6a2a21a..a7a7c2b78 100644 --- a/gcloud/beta/ai/models/describe +++ b/gcloud/beta/ai/models/describe @@ -12,6 +12,12 @@ EXAMPLES $ gcloud beta ai models describe 123 --project=example \ --region=us-central1 + Describe a model 123 of version 2 of project example in region us-central1, + run: + + $ gcloud beta ai models describe 123@2 --project=example \ + --region=us-central1 + POSITIONAL ARGUMENTS Model resource - Model to describe. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some attributes diff --git a/gcloud/beta/ai/models/help b/gcloud/beta/ai/models/help index 1b34964a3..b54cfd059 100644 --- a/gcloud/beta/ai/models/help +++ b/gcloud/beta/ai/models/help @@ -27,6 +27,9 @@ COMMANDS list (BETA) List the models of the given project and region. + list-version + (BETA) List the model versions of the given region and model. + upload (BETA) Upload a new model. diff --git a/gcloud/beta/ai/models/list-version b/gcloud/beta/ai/models/list-version new file mode 100644 index 000000000..f234c6baa --- /dev/null +++ b/gcloud/beta/ai/models/list-version @@ -0,0 +1,92 @@ +NAME + gcloud beta ai models list-version - list the model versions of the given + region and model + +SYNOPSIS + gcloud beta ai models list-version (MODEL : --region=REGION) + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +EXAMPLES + List the model version of a model 123 of project example in region + us-central1, run: + + $ gcloud beta ai models list-version 123 --project=example \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Model resource - Model to list versions. The arguments in this group can + be used to specify the attributes of this resource. (NOTE) 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. + + This positional must be specified if any of the other arguments in + this group are specified. + + --region=REGION + Cloud region for the model. To set the region attribute: + ▸ provide the argument model on the command line with a fully + specified name; + ▸ provide the argument --region on the command line; + ▸ set the property ai/region; + ▸ choose one from the prompted list of available regions. + +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 ai models list-version + + $ gcloud alpha ai models list-version + diff --git a/gcloud/beta/asset/analyze-iam-policy b/gcloud/beta/asset/analyze-iam-policy deleted file mode 100644 index 24ffec218..000000000 --- a/gcloud/beta/asset/analyze-iam-policy +++ /dev/null @@ -1,135 +0,0 @@ -NAME - gcloud beta asset analyze-iam-policy - analyzes IAM policies that match a - request - -SYNOPSIS - gcloud beta asset analyze-iam-policy - (--folder=FOLDER_ID | --organization=ORGANIZATION_ID - | --project=PROJECT_ID) [--full-resource-name=FULL_RESOURCE_NAME] - [--identity=IDENTITY] - [--analyze-service-account-impersonation - --execution-timeout=EXECUTION_TIMEOUT --expand-groups - --expand-resources --expand-roles - --output-group-edges --output-resource-edges --show-response] - [--permissions=[PERMISSIONS,...] --roles=[ROLES,...]] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Analyzes IAM policies that match a request. - -EXAMPLES - To find out which users have been granted the iam.serviceAccounts.actAs - permission on a service account, run: - - $ gcloud beta asset analyze-iam-policy --organization=YOUR_ORG_ID \ - --full-resource-name=YOUR_SERVICE_ACCOUNT_FULL_RESOURCE_NAME \ - --permissions='iam.serviceAccounts.actAs' - - To find out which resources a user can access, run: - - $ gcloud beta asset analyze-iam-policy --organization=YOUR_ORG_ID \ - --identity='user:u1@foo.com' - - To find out which roles or permissions a user has been granted on a - project, run: - - $ gcloud beta asset analyze-iam-policy --organization=YOUR_ORG_ID \ - --full-resource-name=YOUR_PROJECT_FULL_RESOURCE_NAME \ - --identity='user:u1@foo.com' - - To find out which users have been granted the iam.serviceAccounts.actAs - permission on any applicable resources, run: - - $ gcloud beta asset analyze-iam-policy --organization=YOUR_ORG_ID \ - --permissions='iam.serviceAccounts.actAs' - -REQUIRED FLAGS - Exactly one of these must be specified: - - --folder=FOLDER_ID - Folder ID on which to perform the analysis. Only policies defined at - or below this folder will be targeted in the analysis. - - --organization=ORGANIZATION_ID - Organization ID on which to perform the analysis. Only policies - defined at or below this organization will be targeted in the - analysis. - - --project=PROJECT_ID - Project ID or number on which to perform the analysis. Only policies - defined at or below this project will be targeted in the analysis. - -OPTIONAL FLAGS - Specifies a resource for analysis. Leaving it empty means ANY. - - --full-resource-name=FULL_RESOURCE_NAME - The full resource name. - - Specifies an identity for analysis. Leaving it empty means ANY. - - --identity=IDENTITY - The identity appearing in the form of principals in the IAM policy - binding. - - The analysis options. - - --analyze-service-account-impersonation - If true, the response will include access analysis from identities to - resources via service account impersonation. This is a very expensive - operation, because many derived queries will be executed. We highly - recommend you use AnalyzeIamPolicyLongrunning rpc instead. Default is - false. - - --execution-timeout=EXECUTION_TIMEOUT - The amount of time the executable has to complete. See JSON - representation of Duration - (https://developers.google.com/protocol-buffers/docs/proto3#json). - Deafult is empty. - - --expand-groups - If true, the identities section of the result will expand any Google - groups appearing in an IAM policy binding. Default is false. - - --expand-resources - If true, the resource section of the result will expand any resource - attached to an IAM policy to include resources lower in the resource - hierarchy. Default is false. - - --expand-roles - If true, the access section of result will expand any roles appearing - in IAM policy bindings to include their permissions. Default is - false. - - --output-group-edges - If true, the result will output the relevant membership relationships - between groups. Default is false. - - --output-resource-edges - If true, the result will output the relevant parent/child - relationships between resources. Default is false. - - --show-response - If true, the response will be showed as-is in the command output. - - Specifies roles or permissions for analysis. Leaving it empty means ANY. - - --permissions=[PERMISSIONS,...] - The permissions to appear in the result. - - --roles=[ROLES,...] - The roles to appear in the result. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -NOTES - This command is currently in beta and might change without notice. This - variant is also available: - - $ gcloud asset analyze-iam-policy - diff --git a/gcloud/beta/asset/export-iam-policy-analysis b/gcloud/beta/asset/export-iam-policy-analysis deleted file mode 100644 index 6d8f77183..000000000 --- a/gcloud/beta/asset/export-iam-policy-analysis +++ /dev/null @@ -1,138 +0,0 @@ -NAME - gcloud beta asset export-iam-policy-analysis - export IAM policy analysis - that match a request to Google Cloud Storage - -SYNOPSIS - gcloud beta asset export-iam-policy-analysis --output-path=OUTPUT_PATH - (--folder=FOLDER_ID | --organization=ORGANIZATION_ID - | --project=PROJECT_ID) [--full-resource-name=FULL_RESOURCE_NAME] - [--identity=IDENTITY] - [--analyze-service-account-impersonation --expand-groups - --expand-resources - --expand-roles --output-group-edges --output-resource-edges] - [--permissions=[PERMISSIONS,...] --roles=[ROLES,...]] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Export IAM policy analysis that matches a request to Google Cloud - Storage. - -EXAMPLES - To find out which users have been granted the iam.serviceAccounts.actAs - permission on a service account, run: - - $ gcloud beta asset export-iam-policy-analysis \ - --organization=YOUR_ORG_ID \ - --full-resource-name=YOUR_SERVICE_ACCOUNT_FULL_RESOURCE_NAME \ - --permissions='iam.serviceAccounts.actAs' \ - --output-path='gs://YOUR_BUCKET_NAME/YOUR_OBJECT_NAME' - - To find out which resources a user can access, run: - - $ gcloud beta asset export-iam-policy-analysis \ - --organization=YOUR_ORG_ID --identity='user:u1@foo.com' \ - --output-path='gs://YOUR_BUCKET_NAME/YOUR_OBJECT_NAME' - - To find out which roles or permissions a user has been granted on a - project, run: - - $ gcloud beta asset export-iam-policy-analysis \ - --organization=YOUR_ORG_ID \ - --full-resource-name=YOUR_PROJECT_FULL_RESOURCE_NAME \ - --identity='user:u1@foo.com' \ - --output-path='gs://YOUR_BUCKET_NAME/YOUR_OBJECT_NAME' - - To find out which users have been granted the iam.serviceAccounts.actAs - permission on any applicable resources, run: - - $ gcloud beta asset export-iam-policy-analysis \ - --organization=YOUR_ORG_ID \ - --permissions='iam.serviceAccounts.actAs' \ - --output-path='gs://YOUR_BUCKET_NAME/YOUR_OBJECT_NAME' - -REQUIRED FLAGS - The destination path for exporting IAM policy analysis. - - This must be specified. - - --output-path=OUTPUT_PATH - Google Cloud Storage URI where the results will go. URI must start - with "gs://". For example, "gs://bucket_name/object_name" - - Exactly one of these must be specified: - - --folder=FOLDER_ID - Folder ID on which to perform the analysis. Only policies defined at - or below this folder will be targeted in the analysis. - - --organization=ORGANIZATION_ID - Organization ID on which to perform the analysis. Only policies - defined at or below this organization will be targeted in the - analysis. - - --project=PROJECT_ID - Project ID or number on which to perform the analysis. Only policies - defined at or below this project will be targeted in the analysis. - -OPTIONAL FLAGS - Specifies a resource for analysis. Leaving it empty means ANY. - - --full-resource-name=FULL_RESOURCE_NAME - The full resource name. - - Specifies an identity for analysis. Leaving it empty means ANY. - - --identity=IDENTITY - The identity appearing in the form of principals in the IAM policy - binding. - - The analysis options. - - --analyze-service-account-impersonation - If true, the response will include access analysis from identities to - resources via service account impersonation. This is a very expensive - operation, because many derived queries will be executed. We highly - recommend you use AnalyzeIamPolicyLongrunning rpc instead. Default is - false. - - --expand-groups - If true, the identities section of the result will expand any Google - groups appearing in an IAM policy binding. Default is false. - - --expand-resources - If true, the resource section of the result will expand any resource - attached to an IAM policy to include resources lower in the resource - hierarchy. Default is false. - - --expand-roles - If true, the access section of result will expand any roles appearing - in IAM policy bindings to include their permissions. Default is - false. - - --output-group-edges - If true, the result will output the relevant membership relationships - between groups. Default is false. - - --output-resource-edges - If true, the result will output the relevant parent/child - relationships between resources. Default is false. - - Specifies roles or permissions for analysis. Leaving it empty means ANY. - - --permissions=[PERMISSIONS,...] - The permissions to appear in the result. - - --roles=[ROLES,...] - The roles to appear in the result. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -NOTES - This command is currently in beta and might change without notice. - diff --git a/gcloud/beta/asset/help b/gcloud/beta/asset/help index 524a25c33..0872bf807 100644 --- a/gcloud/beta/asset/help +++ b/gcloud/beta/asset/help @@ -24,16 +24,9 @@ GROUPS COMMANDS COMMAND is one of the following: - analyze-iam-policy - (BETA) Analyzes IAM policies that match a request. - export (BETA) Export the cloud assets to Google Cloud Storage/BigQuery. - export-iam-policy-analysis - (BETA) Export IAM policy analysis that match a request to Google Cloud - Storage. - get-history (BETA) Get the update history of assets that overlaps a time window. diff --git a/gcloud/beta/batch/help b/gcloud/beta/batch/help new file mode 100644 index 000000000..cb5614a2c --- /dev/null +++ b/gcloud/beta/batch/help @@ -0,0 +1,29 @@ +NAME + gcloud beta batch - manage Batch resources + +SYNOPSIS + gcloud beta batch GROUP [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Batch resources. + +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) Manage Batch job resources. + + tasks + (BETA) Manage Batch task resources. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha batch + diff --git a/gcloud/beta/batch/jobs/delete b/gcloud/beta/batch/jobs/delete new file mode 100644 index 000000000..4f39317c2 --- /dev/null +++ b/gcloud/beta/batch/jobs/delete @@ -0,0 +1,59 @@ +NAME + gcloud beta batch jobs delete - delete a job + +SYNOPSIS + gcloud beta batch jobs delete (JOB : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) This command can fail for the following reasons: + ▪ The job specified does not exist. + ▪ The active account does not have permission to delete the given job. + +EXAMPLES + To delete the job with name projects/foo/locations/us-central1/jobs/bar, + run: + + $ gcloud beta batch jobs delete \ + projects/foo/locations/us-central1/jobs/bar + +POSITIONAL ARGUMENTS + Job resource - The Batch job resource. The arguments in this group can be + used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. To set + the project attribute: + ◆ provide the argument JOB 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. + + JOB + ID of the job or fully qualified identifier for the job. To set the + job attribute: + ▸ provide the argument JOB on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + Google Cloud location for the job. To set the location attribute: + ▸ provide the argument JOB on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --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 batch jobs delete + diff --git a/gcloud/beta/batch/jobs/describe b/gcloud/beta/batch/jobs/describe new file mode 100644 index 000000000..eefd211f0 --- /dev/null +++ b/gcloud/beta/batch/jobs/describe @@ -0,0 +1,59 @@ +NAME + gcloud beta batch jobs describe - show details of a job + +SYNOPSIS + gcloud beta batch jobs describe (JOB : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) This command can fail for the following reasons: + ▪ The job specified does not exist. + ▪ The active account does not have permission to access the given job. + +EXAMPLES + To print details of the job with name + projects/foo/locations/us-central1/jobs/bar, run: + + $ gcloud beta batch jobs describe \ + projects/foo/locations/us-central1/jobs/bar + +POSITIONAL ARGUMENTS + Job resource - The Batch job resource. The arguments in this group can be + used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. To set + the project attribute: + ◆ provide the argument JOB 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. + + JOB + ID of the job or fully qualified identifier for the job. To set the + job attribute: + ▸ provide the argument JOB on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + Google Cloud location for the job. To set the location attribute: + ▸ provide the argument JOB on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --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 batch jobs describe + diff --git a/gcloud/beta/batch/jobs/help b/gcloud/beta/batch/jobs/help new file mode 100644 index 000000000..c16366b29 --- /dev/null +++ b/gcloud/beta/batch/jobs/help @@ -0,0 +1,35 @@ +NAME + gcloud beta batch jobs - manage Batch job resources + +SYNOPSIS + gcloud beta batch jobs COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Batch job resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + delete + (BETA) Delete a job. + + describe + (BETA) Show details of a job. + + list + (BETA) List jobs for a specified Batch project/location. + + submit + (BETA) Submit a Batch job. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha batch jobs + diff --git a/gcloud/beta/batch/jobs/list b/gcloud/beta/batch/jobs/list new file mode 100644 index 000000000..7c182ee56 --- /dev/null +++ b/gcloud/beta/batch/jobs/list @@ -0,0 +1,76 @@ +NAME + gcloud beta batch jobs list - list jobs for a specified Batch + project/location + +SYNOPSIS + gcloud beta batch jobs list LOCATION [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) This command can fail for the following reasons: + ▪ The project/location specified do not exist. + ▪ The active account does not have permission to access the given + project/location. + +EXAMPLES + To print all the jobs under projects/location + projects/foo/locations/us-central1, run: + + $ gcloud beta batch jobs list projects/foo/locations/us-central1 + +POSITIONAL ARGUMENTS + Location resource - The Batch location resource. This represents a Cloud + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. To set the project attribute: + ◆ provide the argument LOCATION on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + LOCATION + ID of the location or fully qualified identifier for the location. To + set the location attribute: + ▸ provide the argument LOCATION on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --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 batch jobs list + diff --git a/gcloud/beta/batch/jobs/submit b/gcloud/beta/batch/jobs/submit new file mode 100644 index 000000000..f9c92db81 --- /dev/null +++ b/gcloud/beta/batch/jobs/submit @@ -0,0 +1,129 @@ +NAME + gcloud beta batch jobs submit - submit a Batch job + +SYNOPSIS + gcloud beta batch jobs submit (JOB : --location=LOCATION) + (--config=CONFIG --container-commands-file=CONTAINER_COMMANDS_FILE + --container-entrypoint=CONTAINER_ENTRYPOINT + --container-image-uri=CONTAINER_IMAGE_URI + | --script-file-path=SCRIPT_FILE_PATH | --script-text=SCRIPT_TEXT) + [--machine-type=MACHINE_TYPE] [--priority=PRIORITY] + [--provisioning-model=PROVISIONING_MODEL] + [--network=NETWORK --subnetwork=SUBNETWORK] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) This command can fail for the following reasons: + ▪ The active account does not have permission to create the Batch job. + +EXAMPLES + To submit the job with config.json sample config file and name + projects/foo/locations/us-central1/jobs/bar, run: + + $ gcloud beta batch jobs submit \ + projects/foo/locations/us-central1/jobs/bar --config=config.json + +POSITIONAL ARGUMENTS + Job resource - The Batch job resource. The arguments in this group can be + used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. To set + the project attribute: + ◆ provide the argument JOB 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. + + JOB + ID of the job or fully qualified identifier for the job. To set the + job attribute: + ▸ provide the argument JOB on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + Google Cloud location for the job. To set the location attribute: + ▸ provide the argument JOB on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + At least one of these must be specified: + + --config=CONFIG + The JSON file of the job config. + + Either specify the config file for the job or the first runnable in the + task spec. Specify either a script file or container arguments for the + first runnable in the task spec. + + At most one of these can be specified: + + Options to specify the container arguments for the first runnable in + the task spec. + + --container-commands-file=CONTAINER_COMMANDS_FILE + Overrides the CMD specified in the container. If there is an + ENTRYPOINT (either in the container image or with the entrypoint + field below) then commands are appended as arguments to the + ENTRYPOINT. + + --container-entrypoint=CONTAINER_ENTRYPOINT + Overrides the ENTRYPOINT specified in the container. + + --container-image-uri=CONTAINER_IMAGE_URI + The URI to pull the container image from. + + Either specify a path to a script file to run or provide inline text + to execute directly. + + At most one of these can be specified: + + --script-file-path=SCRIPT_FILE_PATH + Path to script file to run as first runnable in task spec. File + path should be a valid path on the instance volume. + + --script-text=SCRIPT_TEXT + Text to run as first runnable in task spec. + +OPTIONAL FLAGS + --machine-type=MACHINE_TYPE + Specify the Compute Engine machine type, for example, e2-standard-4. + Currently only one machine type is supported. + + --priority=PRIORITY + Job priority [0-99] 0 is the lowest priority. + + --provisioning-model=PROVISIONING_MODEL + Specify the allowed provisioning model for the compute instances. + PROVISIONING_MODEL must be one of: + + SPOT + The SPOT VM provisioning model. Ideal for fault-tolerant workloads + that can withstand preemption. + STANDARD + The STANDARD VM provisioning model + + --network=NETWORK + The URL for the network resource. Must specify subnetwork as well if + network is specified + + --subnetwork=SUBNETWORK + The URL for the subnetwork resource. Must specify network as well if + subnetwork is 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. This + variant is also available: + + $ gcloud alpha batch jobs submit + diff --git a/gcloud/beta/batch/tasks/describe b/gcloud/beta/batch/tasks/describe new file mode 100644 index 000000000..40cc3b3de --- /dev/null +++ b/gcloud/beta/batch/tasks/describe @@ -0,0 +1,73 @@ +NAME + gcloud beta batch tasks describe - show details of a task + +SYNOPSIS + gcloud beta batch tasks describe + (TASK : --job=JOB --location=LOCATION --task_group=TASK_GROUP) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) This command can fail for the following reasons: + ▪ The task specified does not exist. + ▪ The active account does not have permission to access the given task. + +EXAMPLES + To print details of the task with name + projects/foo/locations/us-central1/jobs/bar/taskGroups/group0/tasks/0, run: + + $ gcloud beta batch tasks describe \ + projects/foo/locations/us-central1/jobs/bar/taskGroups/group0/\ + tasks/0 + +POSITIONAL ARGUMENTS + Task resource - The Batch task resource. The arguments in this group can + be used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. To set + the project attribute: + ◆ provide the argument TASK 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. + + TASK + ID of the task or fully qualified identifier for the task. To set the + task attribute: + ▸ provide the argument TASK on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --job=JOB + The job ID for the task. To set the job attribute: + ▸ provide the argument TASK on the command line with a fully + specified name; + ▸ provide the argument --job on the command line. + + --location=LOCATION + Google Cloud location for the task. To set the location attribute: + ▸ provide the argument TASK on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --task_group=TASK_GROUP + The task_group ID for the task. To set the task_group attribute: + ▸ provide the argument TASK on the command line with a fully + specified name; + ▸ provide the argument --task_group on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha batch tasks describe + diff --git a/gcloud/beta/batch/tasks/help b/gcloud/beta/batch/tasks/help new file mode 100644 index 000000000..560785d12 --- /dev/null +++ b/gcloud/beta/batch/tasks/help @@ -0,0 +1,29 @@ +NAME + gcloud beta batch tasks - manage Batch task resources + +SYNOPSIS + gcloud beta batch tasks COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Batch task resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + (BETA) Show details of a task. + + list + (BETA) List tasks for a specified Batch task_group. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha batch tasks + diff --git a/gcloud/beta/batch/tasks/list b/gcloud/beta/batch/tasks/list new file mode 100644 index 000000000..d9a6952c0 --- /dev/null +++ b/gcloud/beta/batch/tasks/list @@ -0,0 +1,94 @@ +NAME + gcloud beta batch tasks list - list tasks for a specified Batch task_group + +SYNOPSIS + gcloud beta batch tasks list (TASK_GROUP : --job=JOB --location=LOCATION) + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) This command can fail for the following reasons: + ▪ The task_group specified does not exist. + ▪ The active account does not have permission to access the given + task_group. + +EXAMPLES + To print all tasks under the task_group with name + projects/foo/locations/us-central1/jobs/bar/taskGroups/group0, run: + + $ gcloud beta batch tasks list \ + projects/foo/locations/us-central1/jobs/bar/taskGroups/group0 + +POSITIONAL ARGUMENTS + Task group resource - The Batch task_group resource. The arguments in this + group can be used to specify the attributes of this resource. (NOTE) Some + attributes are not given arguments in this group but can be set in other + ways. To set the project attribute: + ◆ provide the argument TASK_GROUP on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + TASK_GROUP + ID of the task_group or fully qualified identifier for the + task_group. To set the task_group attribute: + ▸ provide the argument TASK_GROUP on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --job=JOB + The job ID for the task_group. To set the job attribute: + ▸ provide the argument TASK_GROUP on the command line with a fully + specified name; + ▸ provide the argument --job on the command line. + + --location=LOCATION + Google Cloud location for the task_group. To set the location + attribute: + ▸ provide the argument TASK_GROUP on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --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 batch tasks list + diff --git a/gcloud/beta/compute/disks/create b/gcloud/beta/compute/disks/create index 0a7fb0671..95327492c 100644 --- a/gcloud/beta/compute/disks/create +++ b/gcloud/beta/compute/disks/create @@ -138,11 +138,10 @@ FLAGS Size of the disks. The value must be a whole number followed by a size unit of GB for gigabyte, or TB for terabyte. If no size unit is specified, GB is assumed. For example, 10GB will produce 10 gigabyte - disks. Disk size must be a multiple of 1 GB. Limit your boot disk size - to 2TB to account for MBR partition table limitations. If disk size is - not specified, the default size of 500GB for pd-standard disks, 100GB - for pd-balanced disks, 100GB for pd-ssd disks, and 1000GB for - pd-extreme will be used. For details about disk size limits, refer to: + disks. Disk size must be a multiple of 1 GB. If disk size is not + specified, the default size of 500GB for pd-standard disks, 100GB for + pd-balanced disks, 100GB for pd-ssd disks, and 1000GB for pd-extreme + will be used. For details about disk size limits, refer to: https://cloud.google.com/compute/docs/disks --type=TYPE diff --git a/gcloud/beta/compute/security-policies/update b/gcloud/beta/compute/security-policies/update index 525a79302..1d242a7e0 100644 --- a/gcloud/beta/compute/security-policies/update +++ b/gcloud/beta/compute/security-policies/update @@ -6,6 +6,10 @@ SYNOPSIS gcloud beta compute security-policies update NAME [--description=DESCRIPTION] [--enable-layer7-ddos-defense] [--json-parsing=JSON_PARSING] + [--layer7-ddos-defense-auto-deploy-confidence-threshold=LAYER7_DDOS_DEFENSE_AUTO_DEPLOY_CONFIDENCE_THRESHOLD] + [--layer7-ddos-defense-auto-deploy-expiration-sec=LAYER7_DDOS_DEFENSE_AUTO_DEPLOY_EXPIRATION_SEC] + [--layer7-ddos-defense-auto-deploy-impacted-baseline-threshold=LAYER7_DDOS_DEFENSE_AUTO_DEPLOY_IMPACTED_BASELINE_THRESHOLD] + [--layer7-ddos-defense-auto-deploy-load-threshold=LAYER7_DDOS_DEFENSE_AUTO_DEPLOY_LOAD_THRESHOLD] [--layer7-ddos-defense-rule-visibility=VISIBILITY_TYPE] [--log-level=LOG_LEVEL] [--network-ddos-protection=NETWORK_DDOS_PROTECTION] @@ -38,6 +42,21 @@ FLAGS values: [DISABLED, STANDARD]. JSON_PARSING must be one of: DISABLED, STANDARD. + --layer7-ddos-defense-auto-deploy-confidence-threshold=LAYER7_DDOS_DEFENSE_AUTO_DEPLOY_CONFIDENCE_THRESHOLD + Confidence threshold above which Adaptive Protection's auto-deploy + takes actions + + --layer7-ddos-defense-auto-deploy-expiration-sec=LAYER7_DDOS_DEFENSE_AUTO_DEPLOY_EXPIRATION_SEC + Duration over which Adaptive Protection's auto-deployed actions last + + --layer7-ddos-defense-auto-deploy-impacted-baseline-threshold=LAYER7_DDOS_DEFENSE_AUTO_DEPLOY_IMPACTED_BASELINE_THRESHOLD + Impacted baseline threshold below which Adaptive Protection's + auto-deploy takes actions + + --layer7-ddos-defense-auto-deploy-load-threshold=LAYER7_DDOS_DEFENSE_AUTO_DEPLOY_LOAD_THRESHOLD + Load threshold above which Adaptive Protection's auto-deploy takes + actions + --layer7-ddos-defense-rule-visibility=VISIBILITY_TYPE The visibility type indicates whether the rules are opaque or transparent. VISIBILITY_TYPE must be one of: STANDARD, PREMIUM. diff --git a/gcloud/beta/deploy/releases/create b/gcloud/beta/deploy/releases/create index 28c667dd8..bae0e1345 100644 --- a/gcloud/beta/deploy/releases/create +++ b/gcloud/beta/deploy/releases/create @@ -11,6 +11,7 @@ SYNOPSIS [--skaffold-file=SKAFFOLD_FILE] [--skaffold-version=SKAFFOLD_VERSION] [--source=SOURCE; default="."] [--to-target=TO_TARGET] [--build-artifacts=BUILD_ARTIFACTS | --images=[NAME=TAG,...]] + [--disable-initial-rollout | --enable-initial-rollout] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -101,7 +102,7 @@ FLAGS A directory in Google Cloud Storage to copy the source used for staging the build. If the specified bucket does not exist, Cloud Deploy will create one. If you don't set this field, - gs://[PROJECT_ID]_clouddeploy/source is used. + gs://[DELIVERY_PIPELINE_ID]_clouddeploy/source is used. --ignore-file=IGNORE_FILE Override the .gcloudignore file and use the specified file instead. @@ -165,6 +166,16 @@ FLAGS $ gcloud deploy releases create foo \ --images image1=path/to/image1:v1@sha256:45db24 + At most one of these can be specified: + + --disable-initial-rollout + Skips creating a rollout in the first target defined in the delivery + pipeline. + + --enable-initial-rollout + Creates a rollout in the first target defined in the delivery + pipeline. This is the default behavior. + 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/iam/policies/delete b/gcloud/beta/iam/policies/delete index b7c76492d..ea374dbc2 100644 --- a/gcloud/beta/iam/policies/delete +++ b/gcloud/beta/iam/policies/delete @@ -34,7 +34,7 @@ REQUIRED FLAGS OPTIONAL FLAGS --etag=ETAG Etag that identifies the version of the existing policy. If omitted, - the command gets the etag for the current version of the policy. + the policy is deleted regardless of its current etag. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/iam/policies/update b/gcloud/beta/iam/policies/update index ad48e7f0e..dba0024ae 100644 --- a/gcloud/beta/iam/policies/update +++ b/gcloud/beta/iam/policies/update @@ -5,19 +5,18 @@ NAME SYNOPSIS gcloud beta iam policies update POLICY_ID --attachment-point=ATTACHMENT_POINT --kind=KIND - --policy-file=POLICY_FILE [--etag=ETAG] [GCLOUD_WIDE_FLAG ...] + --policy-file=POLICY_FILE [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Update the policy on the given attachment point with the given name. EXAMPLES The following command updates the IAM policy defined at the resource - project 123 of kind denypolicies and id my-deny-policy, with etag abc: + project 123 of kind denypolicies and id my-deny-policy: $ gcloud beta iam policies update my-deny-policy \ --attachment-point=cloudresourcemanager.googleapis.com/\ - projects/123 --kind=denypolicies --policy-file=policy.json \ - --etag=abc + projects/123 --kind=denypolicies --policy-file=policy.json POSITIONAL ARGUMENTS POLICY_ID @@ -36,11 +35,6 @@ REQUIRED FLAGS Path to the file that contains the policy, in JSON or YAML format. For valid syntax, see https://cloud.google.com/iam/help/deny/policy-syntax. -OPTIONAL FLAGS - --etag=ETAG - Etag that identifies the version of the existing policy. If omitted, - the command gets the etag for the current version of the policy. - 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/kms/import-jobs/create b/gcloud/beta/kms/import-jobs/create index 53d12d8b0..aeb0fbedb 100644 --- a/gcloud/beta/kms/import-jobs/create +++ b/gcloud/beta/kms/import-jobs/create @@ -15,7 +15,7 @@ EXAMPLES $ gcloud beta kms import-jobs create strider \ --location=us-central1 --keyring=fellowship \ - --import-method=rsa-oaep-3072-sha1-aes-256 \ + --import-method=rsa-oaep-3072-sha256-aes-256 \ --protection-level=hsm POSITIONAL ARGUMENTS diff --git a/gcloud/beta/sql/instances/create b/gcloud/beta/sql/instances/create index bde2453d9..fc7841151 100644 --- a/gcloud/beta/sql/instances/create +++ b/gcloud/beta/sql/instances/create @@ -40,7 +40,7 @@ SYNOPSIS [--replica-type=REPLICA_TYPE] [--replication=REPLICATION] [--require-ssl] [--retained-backups-count=RETAINED_BACKUPS_COUNT] [--retained-transaction-log-days=RETAINED_TRANSACTION_LOG_DAYS] - [--root-password=ROOT_PASSWORD] [--storage-auto-increase] + [--root-password=ROOT_PASSWORD] [--[no-]storage-auto-increase] [--storage-auto-increase-limit=STORAGE_AUTO_INCREASE_LIMIT] [--storage-size=STORAGE_SIZE] [--storage-type=STORAGE_TYPE] [--tier=TIER, -t TIER] @@ -341,13 +341,15 @@ FLAGS --root-password=ROOT_PASSWORD Root Cloud SQL user's password. - --storage-auto-increase + --[no-]storage-auto-increase Storage size can be increased, but it cannot be decreased; storage increases are permanent for the life of the instance. With this setting enabled, a spike in storage requirements can result in permanently increased storage costs for your instance. However, if an instance runs out of available space, it can result in the instance going offline, - dropping existing connections. This setting is enabled by default. + dropping existing connections. This setting is enabled by default. Use + --storage-auto-increase to enable and --no-storage-auto-increase to + disable. --storage-auto-increase-limit=STORAGE_AUTO_INCREASE_LIMIT Allows you to set a maximum storage capacity, in GB. Automatic diff --git a/gcloud/beta/sql/instances/patch b/gcloud/beta/sql/instances/patch index 01c3ef5e0..abd890d70 100644 --- a/gcloud/beta/sql/instances/patch +++ b/gcloud/beta/sql/instances/patch @@ -35,7 +35,7 @@ SYNOPSIS [--password-policy-reuse-interval=PASSWORD_POLICY_REUSE_INTERVAL] [--pricing-plan=PRICING_PLAN, -p PRICING_PLAN] [--remove-deny-maintenance-period] [--replication=REPLICATION] - [--[no-]require-ssl] [--storage-auto-increase] + [--[no-]require-ssl] [--[no-]storage-auto-increase] [--storage-auto-increase-limit=STORAGE_AUTO_INCREASE_LIMIT] [--storage-size=STORAGE_SIZE] [--tier=TIER, -t TIER] [--update-labels=[KEY=VALUE,...]] @@ -278,13 +278,15 @@ FLAGS mysqld should default to 'REQUIRE X509' for users connecting over IP. Use --require-ssl to enable and --no-require-ssl to disable. - --storage-auto-increase + --[no-]storage-auto-increase Storage size can be increased, but it cannot be decreased; storage increases are permanent for the life of the instance. With this setting enabled, a spike in storage requirements can result in permanently increased storage costs for your instance. However, if an instance runs out of available space, it can result in the instance going offline, - dropping existing connections. This setting is enabled by default. + dropping existing connections. This setting is enabled by default. Use + --storage-auto-increase to enable and --no-storage-auto-increase to + disable. --storage-auto-increase-limit=STORAGE_AUTO_INCREASE_LIMIT Allows you to set a maximum storage capacity, in GB. Automatic diff --git a/gcloud/bms/instances/update b/gcloud/bms/instances/update index f071a59ed..e3506af9b 100644 --- a/gcloud/bms/instances/update +++ b/gcloud/bms/instances/update @@ -3,6 +3,7 @@ NAME SYNOPSIS gcloud bms instances update (INSTANCE : --region=REGION) [--async] + [--[no-]enable-hyperthreading] [--os-image=OS_IMAGE] [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] @@ -56,6 +57,13 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --[no-]enable-hyperthreading + Enable hyperthreading for the server. Use --enable-hyperthreading to + enable and --no-enable-hyperthreading to disable. + + --os-image=OS_IMAGE + OS image to install on the server. + --update-labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to update. If a label exists, its value is modified. Otherwise, a new label is created. diff --git a/gcloud/bms/networks/help b/gcloud/bms/networks/help index 38fe7c828..282faed1a 100644 --- a/gcloud/bms/networks/help +++ b/gcloud/bms/networks/help @@ -21,6 +21,10 @@ COMMANDS list List Bare Metal Solution networks in a project. + list-ip-reservations + List IP range reservations for Bare Metal Solution networks in a + project. + update Update a Bare Metal Solution network. diff --git a/gcloud/bms/networks/list-ip-reservations b/gcloud/bms/networks/list-ip-reservations new file mode 100644 index 000000000..9334b8f1c --- /dev/null +++ b/gcloud/bms/networks/list-ip-reservations @@ -0,0 +1,62 @@ +NAME + gcloud bms networks list-ip-reservations - list IP range reservations for + Bare Metal Solution networks in a project + +SYNOPSIS + gcloud bms networks list-ip-reservations --region=REGION + [--filter=EXPRESSION] [--limit=LIMIT] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List IP range reservations for Bare Metal Solution networks in a project. + +EXAMPLES + To list IP range reservations for networks in the region us-central1, run: + + $ gcloud bms networks list-ip-reservations --region=us-central1 + + Or: + + To list all IP range reservations in the project, run: + + $ gcloud bms networks list-ip-reservations + +FLAGS + Region resource - region. 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 --region on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + --region=REGION + ID of the region or fully qualified identifier for the region. To set + the region attribute: + ▸ provide the argument --region on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --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 bms networks list-ip-reservations + diff --git a/gcloud/bms/networks/update b/gcloud/bms/networks/update index 729ef15f8..493cd83dd 100644 --- a/gcloud/bms/networks/update +++ b/gcloud/bms/networks/update @@ -4,6 +4,9 @@ NAME SYNOPSIS gcloud bms networks update (NETWORK : --region=REGION) [--async] [--update-labels=[KEY=VALUE,...]] + [--add-ip-range-reservation=[PROPERTY=VALUE,...] + | --clear-ip-range-reservations + | --remove-ip-range-reservation=[PROPERTY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -65,6 +68,36 @@ FLAGS contain only hyphens (-), underscores (_), lowercase characters, and numbers. + At most one of these can be specified: + + --add-ip-range-reservation=[PROPERTY=VALUE,...] + Add a reservation of a range of IP addresses in the network. + + start_address + The first address of this reservation block. Must be specified as + a single IPv4 address, e.g. 10.1.2.2. + + end_address + The last address of this reservation block, inclusive. I.e., for + cases when reservations are only single addresses, end_address + and start_address will be the same. Must be specified as a single + IPv4 address, e.g. 10.1.2.2. + + note + A note about this reservation, intended for human consumption. + + --clear-ip-range-reservations + Removes all IP range reservations in the network. + + --remove-ip-range-reservation=[PROPERTY=VALUE,...] + Remove a reservation of a range of IP addresses in the network. + + start_address + The first address of the reservation block to remove. + + end_address + The last address of the reservation block to remove. + At most one of these can be specified: --clear-labels diff --git a/gcloud/bms/operations/describe b/gcloud/bms/operations/describe index 1f927fb8f..126ce016b 100644 --- a/gcloud/bms/operations/describe +++ b/gcloud/bms/operations/describe @@ -3,7 +3,8 @@ NAME operation SYNOPSIS - gcloud bms operations describe OPERATION [GCLOUD_WIDE_FLAG ...] + gcloud bms operations describe (OPERATION : --region=REGION) + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Display all metadata associated with a Bare Metal Solution operation given @@ -16,7 +17,14 @@ EXAMPLES POSITIONAL ARGUMENTS Operation resource - Arguments and flags that specify the Bare Metal - Solution operation you want to describe. This represents a Cloud resource. + Solution operation you want to describe. The arguments in this group can + be used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. To set + the project attribute: + ◆ provide the argument operation on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. This must be specified. @@ -25,6 +33,16 @@ POSITIONAL ARGUMENTS To set the operation attribute: ▸ provide the argument operation on the command line. + This positional must be specified if any of the other arguments in + this group are specified. + + --region=REGION + Region of the resource. To set the region attribute: + ▸ provide the argument operation on the command line with a fully + specified name; + ▸ provide the argument --region on the command line; + ▸ global is the only supported location. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, @@ -34,5 +52,5 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the baremetalsolution/v1 API. The full documentation for + This command uses the baremetalsolution/v2 API. The full documentation for this API can be found at: https://cloud.google.com/bare-metal diff --git a/gcloud/bms/operations/wait b/gcloud/bms/operations/wait index a58fe0aa2..6097d9654 100644 --- a/gcloud/bms/operations/wait +++ b/gcloud/bms/operations/wait @@ -3,7 +3,8 @@ NAME operation until it completes SYNOPSIS - gcloud bms operations wait OPERATION [GCLOUD_WIDE_FLAG ...] + gcloud bms operations wait (OPERATION : --region=REGION) + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Poll a long-running Bare Metal Solution operation until it completes. When @@ -18,7 +19,14 @@ EXAMPLES POSITIONAL ARGUMENTS Operation resource - Arguments and flags that specify the Bare Metal - Solution operation you want to wait for. This represents a Cloud resource. + Solution operation you want to wait for. The arguments in this group can + be used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. To set + the project attribute: + ◆ provide the argument operation on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. This must be specified. @@ -27,6 +35,16 @@ POSITIONAL ARGUMENTS To set the operation attribute: ▸ provide the argument operation on the command line. + This positional must be specified if any of the other arguments in + this group are specified. + + --region=REGION + Region of the resource. To set the region attribute: + ▸ provide the argument operation on the command line with a fully + specified name; + ▸ provide the argument --region on the command line; + ▸ global is the only supported location. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, @@ -36,5 +54,5 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the baremetalsolution/v1 API. The full documentation for + This command uses the baremetalsolution/v2 API. The full documentation for this API can be found at: https://cloud.google.com/bare-metal diff --git a/gcloud/compute/backend-services/create b/gcloud/compute/backend-services/create index c462d2dff..1f5024298 100644 --- a/gcloud/compute/backend-services/create +++ b/gcloud/compute/backend-services/create @@ -17,8 +17,8 @@ SYNOPSIS [--custom-response-header=CUSTOM_RESPONSE_HEADER] [--default-ttl=DEFAULT_TTL] [--description=DESCRIPTION] [--drop-traffic-if-unhealthy] [--[no-]enable-cdn] - [--[no-]enable-logging] [--failover-ratio=FAILOVER_RATIO] - [--health-checks=HEALTH_CHECK,[...]] + [--[no-]enable-logging] [--[no-]enable-strong-affinity] + [--failover-ratio=FAILOVER_RATIO] [--health-checks=HEALTH_CHECK,[...]] [--http-health-checks=HTTP_HEALTH_CHECK,[...]] [--https-health-checks=HTTPS_HEALTH_CHECK,[...]] [--iap=disabled|enabled,[oauth2-client-id=OAUTH2-CLIENT-ID, @@ -252,6 +252,11 @@ FLAGS Logging. Disabled by default. Use --enable-logging to enable and --no-enable-logging to disable. + --[no-]enable-strong-affinity + Enable or disable strong session affinity. This is only available for + loadbalancingScheme EXTERNAL. Use --enable-strong-affinity to enable + and --no-enable-strong-affinity to disable. + --failover-ratio=FAILOVER_RATIO If the ratio of the healthy VMs in the primary backend is at or below this number, traffic arriving at the load-balanced IP will be directed diff --git a/gcloud/compute/backend-services/update b/gcloud/compute/backend-services/update index 68fb86dca..4eeec0889 100644 --- a/gcloud/compute/backend-services/update +++ b/gcloud/compute/backend-services/update @@ -12,9 +12,9 @@ SYNOPSIS [--connection-persistence-on-unhealthy-backends=CONNECTION_PERSISTENCE_ON_UNHEALTHY_BACKENDS] [--description=DESCRIPTION] [--drop-traffic-if-unhealthy] [--edge-security-policy=EDGE_SECURITY_POLICY] [--[no-]enable-cdn] - [--[no-]enable-logging] [--failover-ratio=FAILOVER_RATIO] - [--health-checks=HEALTH_CHECK,[...]] [--no-health-checks] - [--http-health-checks=HTTP_HEALTH_CHECK,[...]] + [--[no-]enable-logging] [--[no-]enable-strong-affinity] + [--failover-ratio=FAILOVER_RATIO] [--health-checks=HEALTH_CHECK,[...]] + [--no-health-checks] [--http-health-checks=HTTP_HEALTH_CHECK,[...]] [--https-health-checks=HTTPS_HEALTH_CHECK,[...]] [--iap=disabled|enabled,[oauth2-client-id=OAUTH2-CLIENT-ID, oauth2-client-secret=OAUTH2-CLIENT-SECRET]] @@ -166,6 +166,11 @@ FLAGS Logging. Disabled by default. Use --enable-logging to enable and --no-enable-logging to disable. + --[no-]enable-strong-affinity + Enable or disable strong session affinity. This is only available for + loadbalancingScheme EXTERNAL. Use --enable-strong-affinity to enable + and --no-enable-strong-affinity to disable. + --failover-ratio=FAILOVER_RATIO If the ratio of the healthy VMs in the primary backend is at or below this number, traffic arriving at the load-balanced IP will be directed diff --git a/gcloud/compute/disks/create b/gcloud/compute/disks/create index 2d6a1f569..f94536b49 100644 --- a/gcloud/compute/disks/create +++ b/gcloud/compute/disks/create @@ -113,11 +113,10 @@ FLAGS Size of the disks. The value must be a whole number followed by a size unit of GB for gigabyte, or TB for terabyte. If no size unit is specified, GB is assumed. For example, 10GB will produce 10 gigabyte - disks. Disk size must be a multiple of 1 GB. Limit your boot disk size - to 2TB to account for MBR partition table limitations. If disk size is - not specified, the default size of 500GB for pd-standard disks, 100GB - for pd-balanced disks, 100GB for pd-ssd disks, and 1000GB for - pd-extreme will be used. For details about disk size limits, refer to: + disks. Disk size must be a multiple of 1 GB. If disk size is not + specified, the default size of 500GB for pd-standard disks, 100GB for + pd-balanced disks, 100GB for pd-ssd disks, and 1000GB for pd-extreme + will be used. For details about disk size limits, refer to: https://cloud.google.com/compute/docs/disks --type=TYPE diff --git a/gcloud/container/azure/node-pools/update b/gcloud/container/azure/node-pools/update index ecd81579d..fb56fd07f 100644 --- a/gcloud/container/azure/node-pools/update +++ b/gcloud/container/azure/node-pools/update @@ -5,8 +5,9 @@ NAME SYNOPSIS gcloud container azure node-pools update (NODE_POOL : --cluster=CLUSTER --location=LOCATION) [--async] - [--node-version=NODE_VERSION] [--validate-only] - [--max-nodes=MAX_NODES --min-nodes=MIN_NODES] [GCLOUD_WIDE_FLAG ...] + [--node-version=NODE_VERSION] [--ssh-public-key=SSH_PUBLIC_KEY] + [--validate-only] [--max-nodes=MAX_NODES --min-nodes=MIN_NODES] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Update a node pool in an Anthos cluster on Azure. @@ -62,6 +63,9 @@ FLAGS --node-version=NODE_VERSION Kubernetes version to use for the node pool. + --ssh-public-key=SSH_PUBLIC_KEY + SSH public key to use for authentication. + --validate-only Validate the update of the node pool, but don't actually perform it. diff --git a/gcloud/deploy/releases/create b/gcloud/deploy/releases/create index 0f6d42274..c22521a05 100644 --- a/gcloud/deploy/releases/create +++ b/gcloud/deploy/releases/create @@ -11,6 +11,7 @@ SYNOPSIS [--skaffold-file=SKAFFOLD_FILE] [--skaffold-version=SKAFFOLD_VERSION] [--source=SOURCE; default="."] [--to-target=TO_TARGET] [--build-artifacts=BUILD_ARTIFACTS | --images=[NAME=TAG,...]] + [--disable-initial-rollout | --enable-initial-rollout] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -101,7 +102,7 @@ FLAGS A directory in Google Cloud Storage to copy the source used for staging the build. If the specified bucket does not exist, Cloud Deploy will create one. If you don't set this field, - gs://[PROJECT_ID]_clouddeploy/source is used. + gs://[DELIVERY_PIPELINE_ID]_clouddeploy/source is used. --ignore-file=IGNORE_FILE Override the .gcloudignore file and use the specified file instead. @@ -164,6 +165,16 @@ FLAGS $ gcloud deploy releases create foo \ --images image1=path/to/image1:v1@sha256:45db24 + At most one of these can be specified: + + --disable-initial-rollout + Skips creating a rollout in the first target defined in the delivery + pipeline. + + --enable-initial-rollout + Creates a rollout in the first target defined in the delivery + pipeline. This is the default behavior. + 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/privateca/pools/create b/gcloud/privateca/pools/create index 22db53c2b..3485cbdc7 100644 --- a/gcloud/privateca/pools/create +++ b/gcloud/privateca/pools/create @@ -67,12 +67,7 @@ FLAGS If this is enabled, the following will happen: 1) The CA certificates will be written to a known location within the CA distribution point. 2) The AIA extension in all issued certificates will point to the CA - cert URL in that distribution point. - - If this gets disabled, the AIA extension will not be written to any - future certificates issued by this CA. However, an existing bucket will - not be deleted, and the CA certificates will not be removed from that - bucket. + cert URL in that distribition point. Note that the same bucket may be used for the CRLs if --publish-crl is set. @@ -85,12 +80,6 @@ FLAGS CDP extension in all future issued certificates will point to the CRL URL in that distribution point. - If this gets disabled, the CDP extension will not be written to any - future certificates issued by CAs in this pool, and new CRLs will not - be published to that bucket (which affects existing certs). However, an - existing bucket will not be deleted, and any existing CRLs will not be - removed from that bucket. - Note that the same bucket may be used for the CA cert if --publish-ca-cert is set. diff --git a/gcloud/sql/instances/create b/gcloud/sql/instances/create index b5b7b9c5c..7fe7c5c17 100644 --- a/gcloud/sql/instances/create +++ b/gcloud/sql/instances/create @@ -38,7 +38,7 @@ SYNOPSIS [--replica-type=REPLICA_TYPE] [--replication=REPLICATION] [--require-ssl] [--retained-backups-count=RETAINED_BACKUPS_COUNT] [--retained-transaction-log-days=RETAINED_TRANSACTION_LOG_DAYS] - [--root-password=ROOT_PASSWORD] [--storage-auto-increase] + [--root-password=ROOT_PASSWORD] [--[no-]storage-auto-increase] [--storage-size=STORAGE_SIZE] [--storage-type=STORAGE_TYPE] [--tier=TIER, -t TIER] [--disk-encryption-key=DISK_ENCRYPTION_KEY @@ -323,13 +323,15 @@ FLAGS --root-password=ROOT_PASSWORD Root Cloud SQL user's password. - --storage-auto-increase + --[no-]storage-auto-increase Storage size can be increased, but it cannot be decreased; storage increases are permanent for the life of the instance. With this setting enabled, a spike in storage requirements can result in permanently increased storage costs for your instance. However, if an instance runs out of available space, it can result in the instance going offline, - dropping existing connections. This setting is enabled by default. + dropping existing connections. This setting is enabled by default. Use + --storage-auto-increase to enable and --no-storage-auto-increase to + disable. --storage-size=STORAGE_SIZE Amount of storage allocated to the instance. Must be an integer number diff --git a/gcloud/sql/instances/patch b/gcloud/sql/instances/patch index 7b1310648..ca868a182 100644 --- a/gcloud/sql/instances/patch +++ b/gcloud/sql/instances/patch @@ -32,7 +32,7 @@ SYNOPSIS [--password-policy-reuse-interval=PASSWORD_POLICY_REUSE_INTERVAL] [--pricing-plan=PRICING_PLAN, -p PRICING_PLAN] [--remove-deny-maintenance-period] [--replication=REPLICATION] - [--[no-]require-ssl] [--storage-auto-increase] + [--[no-]require-ssl] [--[no-]storage-auto-increase] [--storage-size=STORAGE_SIZE] [--tier=TIER, -t TIER] [--authorized-gae-apps=APP,[APP,...] | --clear-gae-apps] [--authorized-networks=NETWORK,[NETWORK,...] @@ -273,13 +273,15 @@ FLAGS mysqld should default to 'REQUIRE X509' for users connecting over IP. Use --require-ssl to enable and --no-require-ssl to disable. - --storage-auto-increase + --[no-]storage-auto-increase Storage size can be increased, but it cannot be decreased; storage increases are permanent for the life of the instance. With this setting enabled, a spike in storage requirements can result in permanently increased storage costs for your instance. However, if an instance runs out of available space, it can result in the instance going offline, - dropping existing connections. This setting is enabled by default. + dropping existing connections. This setting is enabled by default. Use + --storage-auto-increase to enable and --no-storage-auto-increase to + disable. --storage-size=STORAGE_SIZE Amount of storage allocated to the instance. Must be an integer number