diff --git a/gcloud/_version b/gcloud/_version index 58f6211f4..7fc124e03 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,8 +1,8 @@ -Google Cloud SDK 455.0.0 -alpha 2023.11.10 -beta 2023.11.10 -bq 2.0.98 +Google Cloud SDK 456.0.0 +alpha 2023.12.01 +beta 2023.12.01 +bq 2.0.99 bundled-python3-unix 3.11.6 -core 2023.11.10 +core 2023.12.01 gcloud-crc32c 1.0.0 gsutil 5.27 diff --git a/gcloud/alloydb/clusters/create b/gcloud/alloydb/clusters/create index dfa9b8d8d..d6f1db8cb 100644 --- a/gcloud/alloydb/clusters/create +++ b/gcloud/alloydb/clusters/create @@ -5,7 +5,7 @@ NAME SYNOPSIS gcloud alloydb clusters create CLUSTER --password=PASSWORD --region=REGION [--allocated-ip-range-name=ALLOCATED_IP_RANGE_NAME] [--async] - [--network=NETWORK] + [--database-version=DATABASE_VERSION] [--network=NETWORK] [--continuous-backup-recovery-window-days=RECOVERY_PERIOD --enable-continuous-backup [--continuous-backup-encryption-key=CONTINUOUS_BACKUP_ENCRYPTION_KEY @@ -54,6 +54,10 @@ OPTIONAL FLAGS Return immediately, without waiting for the operation in progress to complete. + --database-version=DATABASE_VERSION + Database version of the cluster. DATABASE_VERSION must be one of: + POSTGRES_14, POSTGRES_15. + --network=NETWORK Network in the current project that the instance will be part of. To specify using a network with a shared VPC, use the full URL of the diff --git a/gcloud/alloydb/instances/update b/gcloud/alloydb/instances/update index 02973c700..7cac80143 100644 --- a/gcloud/alloydb/instances/update +++ b/gcloud/alloydb/instances/update @@ -39,7 +39,8 @@ REQUIRED FLAGS OPTIONAL FLAGS --async Return immediately, without waiting for the operation in progress to - complete. + complete. The default is True. Enabled by default, use --no-async to + disable. --availability-type=AVAILABILITY_TYPE Specifies level of availability. AVAILABILITY_TYPE must be one of: diff --git a/gcloud/alpha/alloydb/clusters/create b/gcloud/alpha/alloydb/clusters/create index 9da5b7bd6..e7fe01322 100644 --- a/gcloud/alpha/alloydb/clusters/create +++ b/gcloud/alpha/alloydb/clusters/create @@ -5,7 +5,8 @@ NAME SYNOPSIS gcloud alpha alloydb clusters create CLUSTER --password=PASSWORD --region=REGION [--allocated-ip-range-name=ALLOCATED_IP_RANGE_NAME] - [--async] [--database-version=DATABASE_VERSION] [--network=NETWORK] + [--async] [--database-version=DATABASE_VERSION] + [--enable-private-services-connect] [--network=NETWORK] [--continuous-backup-recovery-window-days=RECOVERY_PERIOD --enable-continuous-backup [--continuous-backup-encryption-key=CONTINUOUS_BACKUP_ENCRYPTION_KEY @@ -58,6 +59,9 @@ OPTIONAL FLAGS Database version of the cluster. DATABASE_VERSION must be one of: POSTGRES_14, POSTGRES_15. + --enable-private-services-connect + Enable Private Services Connect (PSC) connectivity for the cluster. + --network=NETWORK Network in the current project that the instance will be part of. To specify using a network with a shared VPC, use the full URL of the diff --git a/gcloud/alpha/alloydb/instances/update b/gcloud/alpha/alloydb/instances/update index 963bd518f..00a9bcb57 100644 --- a/gcloud/alpha/alloydb/instances/update +++ b/gcloud/alpha/alloydb/instances/update @@ -39,7 +39,8 @@ REQUIRED FLAGS OPTIONAL FLAGS --async Return immediately, without waiting for the operation in progress to - complete. + complete. The default is True. Enabled by default, use --no-async to + disable. --availability-type=AVAILABILITY_TYPE Specifies level of availability. AVAILABILITY_TYPE must be one of: diff --git a/gcloud/alpha/anthos/auth/login b/gcloud/alpha/anthos/auth/login index 18d15031c..64749003a 100644 --- a/gcloud/alpha/anthos/auth/login +++ b/gcloud/alpha/anthos/auth/login @@ -5,8 +5,8 @@ NAME SYNOPSIS gcloud alpha anthos auth login [--cluster=CLUSTER] [--dry-run] [--kubeconfig=KUBECONFIG] [--login-config=LOGIN_CONFIG] - [--login-config-cert=LOGIN_CONFIG_CERT] [--set-preferred-auth] - [--user=USER] [GCLOUD_WIDE_FLAG ...] + [--login-config-cert=LOGIN_CONFIG_CERT] [--server=SERVER] + [--set-preferred-auth] [--user=USER] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Authenticate clusters using the Anthos client. @@ -28,6 +28,16 @@ EXAMPLES $ gcloud alpha anthos auth login --cluster=testcluster \ --login-config=kubectl-anthos-config.yaml --dry-run + To add credentials to default kubeconfig file using server side login: + + $ gcloud alpha anthos auth login --cluster=testcluster \ + --server= + + To add credentials to custom kubeconfig file using server side login: + + $ gcloud alpha anthos auth login --cluster=testcluster \ + --server= --kubeconfig=my.kubeconfig + FLAGS --cluster=CLUSTER Cluster to authenticate against. If no cluster is specified, the @@ -48,6 +58,9 @@ FLAGS Specifies the CA certificate file to be added to trusted pool for making HTTPS connections to a --login-config URL. + --server=SERVER + Specifies the URL of API server of the cluster to authenticate against. + --set-preferred-auth If set, forces update of preferred authentication for given cluster diff --git a/gcloud/alpha/apphub/applications/add-iam-policy-binding b/gcloud/alpha/apphub/applications/add-iam-policy-binding new file mode 100644 index 000000000..9a1f4167a --- /dev/null +++ b/gcloud/alpha/apphub/applications/add-iam-policy-binding @@ -0,0 +1,86 @@ +NAME + gcloud alpha apphub applications add-iam-policy-binding - add IAM policy + binding to an Apphub application + +SYNOPSIS + gcloud alpha apphub applications add-iam-policy-binding + (APPLICATION : --location=LOCATION) --member=PRINCIPAL --role=ROLE + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Add IAM policy binding to an Apphub application. + +EXAMPLES + To add an IAM policy binding for the role of roles/apphub.viewer for the + user test-user@gmail.com to Application my-app in location us-east1, run: + + $ gcloud alpha apphub applications add-iam-policy-binding my-app \ + --location=us-east1 --role=roles/apphub.viewer \ + --member=user:test-user@gmail.com + +POSITIONAL ARGUMENTS + Application resource - The Application ID. The arguments in this group can + be used to specify the attributes of 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 application 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. + + APPLICATION + ID of the application or fully qualified identifier for the + application. + + To set the application attribute: + ▸ provide the argument application on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The Cloud location for the application. + + To set the location attribute: + ▸ provide the argument application on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --member=PRINCIPAL + The principal to add the binding for. Should be of the form + user|group|serviceAccount:email or domain:domain. + + Examples: user:test-user@gmail.com, group:admins@example.com, + serviceAccount:test123@example.domain.com, or + domain:example.domain.com. + + Some resources also accept the following special values: + ◆ allUsers - Special identifier that represents anyone who is on the + internet, with or without a Google account. + ◆ allAuthenticatedUsers - Special identifier that represents anyone + who is authenticated with a Google account or a service account. + + --role=ROLE + Role name to assign to the principal. The role name is the complete + path of a predefined role, such as roles/logging.viewer, or the role ID + for a custom role, such as + organizations/{ORGANIZATION_ID}/roles/logging.viewer. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --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/apphub/applications/create b/gcloud/alpha/apphub/applications/create new file mode 100644 index 000000000..817b556f1 --- /dev/null +++ b/gcloud/alpha/apphub/applications/create @@ -0,0 +1,105 @@ +NAME + gcloud alpha apphub applications create - create an Apphub application + +SYNOPSIS + gcloud alpha apphub applications create (APPLICATION : --location=LOCATION) + --scope-type=SCOPE_TYPE [--async] + [--business-owners=[channel-uri=CHANNEL-URI], + [display-name=DISPLAY-NAME],[email=EMAIL]] + [--criticality=[level=LEVEL],[mission-critical=MISSION-CRITICAL]] + [--description=DESCRIPTION] + [--developer-owners=[channel-uri=CHANNEL-URI], + [display-name=DISPLAY-NAME],[email=EMAIL]] + [--display-name=DISPLAY_NAME] [--environment=ENVIRONMENT] + [--operator-owners=[channel-uri=CHANNEL-URI], + [display-name=DISPLAY-NAME],[email=EMAIL]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create an Apphub application. + +EXAMPLES + To create the Application my-app with scope type REGIONAL in location + us-east1, run: + + $ gcloud alpha apphub applications create my-app \ + --location=us-east1 --scope-type=REGIONAL + +POSITIONAL ARGUMENTS + Application resource - The Application ID. The arguments in this group can + be used to specify the attributes of 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 application 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. + + APPLICATION + ID of the application or fully qualified identifier for the + application. + + To set the application attribute: + ▸ provide the argument application on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The Cloud location for the application. + + To set the location attribute: + ▸ provide the argument application on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --scope-type=SCOPE_TYPE + Scope of the Application. SCOPE_TYPE must be (only one value is + supported): + + REGIONAL + Represents a regional application + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --business-owners=[channel-uri=CHANNEL-URI],[display-name=DISPLAY-NAME],[email=EMAIL] + Business owners of the application + + --criticality=[level=LEVEL],[mission-critical=MISSION-CRITICAL] + Criticality of the application + + --description=DESCRIPTION + Description of the Application + + --developer-owners=[channel-uri=CHANNEL-URI],[display-name=DISPLAY-NAME],[email=EMAIL] + Developer owners of the application + + --display-name=DISPLAY_NAME + Human-friendly display name + + --environment=ENVIRONMENT + Environment of the application + + --operator-owners=[channel-uri=CHANNEL-URI],[display-name=DISPLAY-NAME],[email=EMAIL] + Operator owners of the application + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --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/apphub/applications/delete b/gcloud/alpha/apphub/applications/delete new file mode 100644 index 000000000..f0bf3e89a --- /dev/null +++ b/gcloud/alpha/apphub/applications/delete @@ -0,0 +1,65 @@ +NAME + gcloud alpha apphub applications delete - delete an Apphub application + +SYNOPSIS + gcloud alpha apphub applications delete (APPLICATION : --location=LOCATION) + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete an Apphub application. + +EXAMPLES + To delete the Application my-app in location us-east1, run: + + $ gcloud alpha apphub applications delete my-app --location=us-east1 + +POSITIONAL ARGUMENTS + Application resource - The Application ID. The arguments in this group can + be used to specify the attributes of 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 application 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. + + APPLICATION + ID of the application or fully qualified identifier for the + application. + + To set the application attribute: + ▸ provide the argument application on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The Cloud location for the application. + + To set the location attribute: + ▸ provide the argument application on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails 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/apphub/applications/describe b/gcloud/alpha/apphub/applications/describe new file mode 100644 index 000000000..477a96857 --- /dev/null +++ b/gcloud/alpha/apphub/applications/describe @@ -0,0 +1,61 @@ +NAME + gcloud alpha apphub applications describe - describe an Apphub application + +SYNOPSIS + gcloud alpha apphub applications describe + (APPLICATION : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe an Apphub application. + +EXAMPLES + To describe the Application my-app in location us-east1, run: + + $ gcloud alpha apphub applications describe my-app \ + --location=us-east1 + +POSITIONAL ARGUMENTS + Application resource - The Application ID. The arguments in this group can + be used to specify the attributes of 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 application 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. + + APPLICATION + ID of the application or fully qualified identifier for the + application. + + To set the application attribute: + ▸ provide the argument application on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The Cloud location for the application. + + To set the location attribute: + ▸ provide the argument application 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. + diff --git a/gcloud/alpha/apphub/applications/get-iam-policy b/gcloud/alpha/apphub/applications/get-iam-policy new file mode 100644 index 000000000..c4c9bca9b --- /dev/null +++ b/gcloud/alpha/apphub/applications/get-iam-policy @@ -0,0 +1,92 @@ +NAME + gcloud alpha apphub applications get-iam-policy - get the IAM policy for an + Apphub application + +SYNOPSIS + gcloud alpha apphub applications get-iam-policy + (APPLICATION : --location=LOCATION) [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Returns an empty policy if the application does not have an + existing IAM policy set. + +EXAMPLES + To get the application IAM policy for the Application my-app in in location + us-east1, run: + + $ gcloud alpha apphub applications get-iam-policy my-app \ + --location=us-east1 + +POSITIONAL ARGUMENTS + Application resource - The Application ID. The arguments in this group can + be used to specify the attributes of 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 application 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. + + APPLICATION + ID of the application or fully qualified identifier for the + application. + + To set the application attribute: + ▸ provide the argument application on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The Cloud location for the application. + + To set the location attribute: + ▸ provide the argument application 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. + diff --git a/gcloud/alpha/apphub/applications/help b/gcloud/alpha/apphub/applications/help new file mode 100644 index 000000000..6b1e6e8e9 --- /dev/null +++ b/gcloud/alpha/apphub/applications/help @@ -0,0 +1,60 @@ +NAME + gcloud alpha apphub applications - manage App Hub Applications + +SYNOPSIS + gcloud alpha apphub applications GROUP | COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Commands for managing App Hub Applications. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + services + (ALPHA) Manage App Hub Application Services. + + workloads + (ALPHA) Manage App Hub Application Workloads. + +COMMANDS + COMMAND is one of the following: + + add-iam-policy-binding + (ALPHA) Add IAM policy binding to an Apphub application. + + create + (ALPHA) Create an Apphub application. + + delete + (ALPHA) Delete an Apphub application. + + describe + (ALPHA) Describe an Apphub application. + + get-iam-policy + (ALPHA) Get the IAM policy for an Apphub application. + + list + (ALPHA) List Apphub applications. + + remove-iam-policy-binding + (ALPHA) Remove IAM policy binding from an Apphub application. + + set-iam-policy + (ALPHA) Set the IAM policy for an Apphub application as defined in a + JSON/YAML file. + + update + (ALPHA) Update an Apphub application. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails 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/apphub/applications/list b/gcloud/alpha/apphub/applications/list new file mode 100644 index 000000000..4c820a327 --- /dev/null +++ b/gcloud/alpha/apphub/applications/list @@ -0,0 +1,81 @@ +NAME + gcloud alpha apphub applications list - list Apphub applications + +SYNOPSIS + gcloud alpha apphub applications list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List Apphub applications. + +EXAMPLES + To list all applications in locations us-east1, run: + + $ gcloud alpha apphub applications list --location=us-east1 + +REQUIRED FLAGS + Location resource - Location. 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=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails 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/apphub/applications/remove-iam-policy-binding b/gcloud/alpha/apphub/applications/remove-iam-policy-binding new file mode 100644 index 000000000..44e98275a --- /dev/null +++ b/gcloud/alpha/apphub/applications/remove-iam-policy-binding @@ -0,0 +1,87 @@ +NAME + gcloud alpha apphub applications remove-iam-policy-binding - remove IAM + policy binding from an Apphub application + +SYNOPSIS + gcloud alpha apphub applications remove-iam-policy-binding + (APPLICATION : --location=LOCATION) --member=PRINCIPAL --role=ROLE + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Remove IAM policy binding from an Apphub application. + +EXAMPLES + To remove an IAM policy binding for the role of roles/apphub.viewer for the + user test-user@gmail.com from Application my-app in location us-east1, run: + + $ gcloud alpha apphub applications remove-iam-policy-binding \ + my-app --location=us-east1 --role=roles/apphub.viewer \ + --member=user:test-user@gmail.com + +POSITIONAL ARGUMENTS + Application resource - The Application ID. The arguments in this group can + be used to specify the attributes of 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 application 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. + + APPLICATION + ID of the application or fully qualified identifier for the + application. + + To set the application attribute: + ▸ provide the argument application on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The Cloud location for the application. + + To set the location attribute: + ▸ provide the argument application on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --member=PRINCIPAL + The principal to remove the binding for. Should be of the form + user|group|serviceAccount:email or domain:domain. + + Examples: user:test-user@gmail.com, group:admins@example.com, + serviceAccount:test123@example.domain.com, or + domain:example.domain.com. + + Deleted principals have an additional deleted: prefix and a ?uid=UID + suffix, where UID is a unique identifier for the principal. Example: + deleted:user:test-user@gmail.com?uid=123456789012345678901. + + Some resources also accept the following special values: + ◆ allUsers - Special identifier that represents anyone who is on the + internet, with or without a Google account. + ◆ allAuthenticatedUsers - Special identifier that represents anyone + who is authenticated with a Google account or a service account. + + --role=ROLE + The role to remove the principal from. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --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/apphub/applications/services/create b/gcloud/alpha/apphub/applications/services/create new file mode 100644 index 000000000..6c0a87892 --- /dev/null +++ b/gcloud/alpha/apphub/applications/services/create @@ -0,0 +1,132 @@ +NAME + gcloud alpha apphub applications services create - create an Apphub + application service + +SYNOPSIS + gcloud alpha apphub applications services create + (SERVICE : --application=APPLICATION --location=LOCATION) + --discovered-service=DISCOVERED_SERVICE [--async] + [--business-owners=[channel-uri=CHANNEL-URI], + [display-name=DISPLAY-NAME],[email=EMAIL]] + [--criticality=[level=LEVEL],[mission-critical=MISSION-CRITICAL]] + [--description=DESCRIPTION] + [--developer-owners=[channel-uri=CHANNEL-URI], + [display-name=DISPLAY-NAME],[email=EMAIL]] + [--display-name=DISPLAY_NAME] [--environment=ENVIRONMENT] + [--operator-owners=[channel-uri=CHANNEL-URI], + [display-name=DISPLAY-NAME],[email=EMAIL]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create an Apphub application service. + +EXAMPLES + To create the Service my-service with discovered service + my-discovered-service in the Application my-app in location us-east1, run: + + $ gcloud alpha apphub applications services create my-service \ + --application=my-app --location=us-east1 \ + --discovered-service=my-discovered-service + +POSITIONAL ARGUMENTS + Service resource - The Service 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 SERVICE 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. + + SERVICE + ID of the service or fully qualified identifier for the service. + + To set the service attribute: + ▸ provide the argument SERVICE on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --application=APPLICATION + Name for the application + + To set the application attribute: + ▸ provide the argument SERVICE on the command line with a fully + specified name; + ▸ provide the argument --application on the command line. + + --location=LOCATION + The Cloud location for the service. + + To set the location attribute: + ▸ provide the argument SERVICE on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + DiscoveredService resource - The discovered service 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 --discovered-service on the command line with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument --discovered-service on the command line with a + fully specified name; + ◆ provide the argument --location on the command line. + + This must be specified. + + --discovered-service=DISCOVERED_SERVICE + ID of the discoveredService or fully qualified identifier for the + discoveredService. + + To set the discovered_service attribute: + ▸ provide the argument --discovered-service on the command line. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --business-owners=[channel-uri=CHANNEL-URI],[display-name=DISPLAY-NAME],[email=EMAIL] + Business owners of the service + + --criticality=[level=LEVEL],[mission-critical=MISSION-CRITICAL] + Criticality of the service + + --description=DESCRIPTION + Description of the service + + --developer-owners=[channel-uri=CHANNEL-URI],[display-name=DISPLAY-NAME],[email=EMAIL] + Developer owners of the service + + --display-name=DISPLAY_NAME + Human-friendly display name + + --environment=ENVIRONMENT + Environment of the service + + --operator-owners=[channel-uri=CHANNEL-URI],[display-name=DISPLAY-NAME],[email=EMAIL] + Operator owners of the service + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/apphub/applications/services/delete b/gcloud/alpha/apphub/applications/services/delete new file mode 100644 index 000000000..512ad6f13 --- /dev/null +++ b/gcloud/alpha/apphub/applications/services/delete @@ -0,0 +1,76 @@ +NAME + gcloud alpha apphub applications services delete - delete an Apphub + application service + +SYNOPSIS + gcloud alpha apphub applications services delete + (SERVICE : --application=APPLICATION --location=LOCATION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete an Apphub application service. + +EXAMPLES + To delete the Service my-service from the Application my-app in location + us-east1, run: + + $ gcloud alpha apphub applications services delete my-service \ + --application=my-app --location=us-east1 + +POSITIONAL ARGUMENTS + Service resource - The Service ID. The arguments in this group can be used + to specify the attributes of 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 service 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. + + SERVICE + ID of the service or fully qualified identifier for the service. + + To set the service attribute: + ▸ provide the argument service on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --application=APPLICATION + Name for the application + + To set the application attribute: + ▸ provide the argument service on the command line with a fully + specified name; + ▸ provide the argument --application on the command line. + + --location=LOCATION + The Cloud location for the service. + + To set the location attribute: + ▸ provide the argument service on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails 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/apphub/applications/services/describe b/gcloud/alpha/apphub/applications/services/describe new file mode 100644 index 000000000..a4b685198 --- /dev/null +++ b/gcloud/alpha/apphub/applications/services/describe @@ -0,0 +1,71 @@ +NAME + gcloud alpha apphub applications services describe - describe an Apphub + application service + +SYNOPSIS + gcloud alpha apphub applications services describe + (SERVICE : --application=APPLICATION --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe an Apphub application service. + +EXAMPLES + To describe the Service my-service in the Application my-app in location + us-east1, run: + + $ gcloud alpha apphub applications services describe my-service \ + --application=my-app --location=us-east1 + +POSITIONAL ARGUMENTS + Service resource - The Service ID. The arguments in this group can be used + to specify the attributes of 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 service 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. + + SERVICE + ID of the service or fully qualified identifier for the service. + + To set the service attribute: + ▸ provide the argument service on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --application=APPLICATION + Name for the application + + To set the application attribute: + ▸ provide the argument service on the command line with a fully + specified name; + ▸ provide the argument --application on the command line. + + --location=LOCATION + The Cloud location for the service. + + To set the location attribute: + ▸ provide the argument service 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. + diff --git a/gcloud/alpha/apphub/applications/services/help b/gcloud/alpha/apphub/applications/services/help new file mode 100644 index 000000000..266f1826a --- /dev/null +++ b/gcloud/alpha/apphub/applications/services/help @@ -0,0 +1,39 @@ +NAME + gcloud alpha apphub applications services - manage App Hub Application + Services + +SYNOPSIS + gcloud alpha apphub applications services COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Commands for managing App Hub Application Services. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Create an Apphub application service. + + delete + (ALPHA) Delete an Apphub application service. + + describe + (ALPHA) Describe an Apphub application service. + + list + (ALPHA) List Apphub application services. + + update + (ALPHA) Update an Apphub application service. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails 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/apphub/applications/services/list b/gcloud/alpha/apphub/applications/services/list new file mode 100644 index 000000000..11fd24fee --- /dev/null +++ b/gcloud/alpha/apphub/applications/services/list @@ -0,0 +1,96 @@ +NAME + gcloud alpha apphub applications services list - list Apphub application + services + +SYNOPSIS + gcloud alpha apphub applications services list + (--application=APPLICATION : --location=LOCATION) [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List Apphub application services. + +EXAMPLES + To list all Services in the Application my-app in location us-east1, run: + + $ gcloud alpha apphub applications services list \ + --application=my-app --location=us-east1 + +REQUIRED FLAGS + Application resource - The Application ID. The arguments in this group can + be used to specify the attributes of 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 --application 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. + + --application=APPLICATION + ID of the application or fully qualified identifier for the + application. + + To set the application attribute: + ▸ provide the argument --application on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The Cloud location for the application. + + To set the location attribute: + ▸ provide the argument --application 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. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/apphub/applications/services/update b/gcloud/alpha/apphub/applications/services/update new file mode 100644 index 000000000..4e231041a --- /dev/null +++ b/gcloud/alpha/apphub/applications/services/update @@ -0,0 +1,105 @@ +NAME + gcloud alpha apphub applications services update - update an Apphub + application service + +SYNOPSIS + gcloud alpha apphub applications services update + (SERVICE : --application=APPLICATION --location=LOCATION) [--async] + [--business-owners=[channel-uri=CHANNEL-URI], + [display-name=DISPLAY-NAME],[email=EMAIL]] + [--criticality=[level=LEVEL],[mission-critical=MISSION-CRITICAL]] + [--description=DESCRIPTION] + [--developer-owners=[channel-uri=CHANNEL-URI], + [display-name=DISPLAY-NAME],[email=EMAIL]] + [--display-name=DISPLAY_NAME] [--environment=ENVIRONMENT] + [--operator-owners=[channel-uri=CHANNEL-URI], + [display-name=DISPLAY-NAME],[email=EMAIL]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Update an Apphub application service. + +EXAMPLES + To update the Service my-service with a new environment prod in the + Application my-app in location us-east1, run: + + $ gcloud alpha apphub applications services update my-service \ + --environment=prod --application=my-app --location=us-east1 + +POSITIONAL ARGUMENTS + Service resource - The Service ID. The arguments in this group can be used + to specify the attributes of 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 service 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. + + SERVICE + ID of the service or fully qualified identifier for the service. + + To set the service attribute: + ▸ provide the argument service on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --application=APPLICATION + Name for the application + + To set the application attribute: + ▸ provide the argument service on the command line with a fully + specified name; + ▸ provide the argument --application on the command line. + + --location=LOCATION + The Cloud location for the service. + + To set the location attribute: + ▸ provide the argument service on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --business-owners=[channel-uri=CHANNEL-URI],[display-name=DISPLAY-NAME],[email=EMAIL] + Business owners of the service + + --criticality=[level=LEVEL],[mission-critical=MISSION-CRITICAL] + Criticality of the service + + --description=DESCRIPTION + Description of the service + + --developer-owners=[channel-uri=CHANNEL-URI],[display-name=DISPLAY-NAME],[email=EMAIL] + Developer owners of the service + + --display-name=DISPLAY_NAME + Human-friendly display name + + --environment=ENVIRONMENT + Environment of the service + + --operator-owners=[channel-uri=CHANNEL-URI],[display-name=DISPLAY-NAME],[email=EMAIL] + Operator owners of the service + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/apphub/applications/set-iam-policy b/gcloud/alpha/apphub/applications/set-iam-policy new file mode 100644 index 000000000..5cb93ecc6 --- /dev/null +++ b/gcloud/alpha/apphub/applications/set-iam-policy @@ -0,0 +1,77 @@ +NAME + gcloud alpha apphub applications set-iam-policy - set the IAM policy for an + Apphub application as defined in a JSON/YAML file + +SYNOPSIS + gcloud alpha apphub applications set-iam-policy + (APPLICATION : --location=LOCATION) POLICY_FILE [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) See https://cloud.google.com/iam/docs/managing-policies for details + of the policy file format and contents. + +EXAMPLES + To set the application IAM policy using a json file 'my_policy.json' for + the Application my-app in location us-east1, run: + + $ gcloud alpha apphub applications set-iam-policy my-app \ + --location=us-east1 /path/to/my_policy.json + + To set the application IAM policy using a yaml file 'my_policy.yaml for the + Application my-app in location us-east1, run: + + $ gcloud alpha apphub applications set-iam-policy my-app \ + --location=us-east1 /path/to/my_policy.yaml + +POSITIONAL ARGUMENTS + Application resource - The Application ID. The arguments in this group can + be used to specify the attributes of 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 application 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. + + APPLICATION + ID of the application or fully qualified identifier for the + application. + + To set the application attribute: + ▸ provide the argument application on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The Cloud location for the application. + + To set the location attribute: + ▸ provide the argument application on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + POLICY_FILE + Path to a local JSON or YAML formatted file containing a valid policy. + + The output of the get-iam-policy command is a valid file, as is any + JSON or YAML file conforming to the structure of a Policy + (https://cloud.google.com/iam/reference/rest/v1/Policy). + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --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/apphub/applications/update b/gcloud/alpha/apphub/applications/update new file mode 100644 index 000000000..c98705d3f --- /dev/null +++ b/gcloud/alpha/apphub/applications/update @@ -0,0 +1,97 @@ +NAME + gcloud alpha apphub applications update - update an Apphub application + +SYNOPSIS + gcloud alpha apphub applications update (APPLICATION : --location=LOCATION) + [--async] + [--business-owners=[channel-uri=CHANNEL-URI], + [display-name=DISPLAY-NAME],[email=EMAIL]] + [--criticality=[level=LEVEL],[mission-critical=MISSION-CRITICAL]] + [--description=DESCRIPTION] + [--developer-owners=[channel-uri=CHANNEL-URI], + [display-name=DISPLAY-NAME],[email=EMAIL]] + [--display-name=DISPLAY_NAME] [--environment=ENVIRONMENT] + [--operator-owners=[channel-uri=CHANNEL-URI], + [display-name=DISPLAY-NAME],[email=EMAIL]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Update an Apphub application. + +EXAMPLES + To update the Application my-app with a new environment prod in location + us-east1, run: + + $ gcloud alpha apphub applications update my-app \ + --location=us-east1 --environment=prod + +POSITIONAL ARGUMENTS + Application resource - The Application ID. The arguments in this group can + be used to specify the attributes of 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 application 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. + + APPLICATION + ID of the application or fully qualified identifier for the + application. + + To set the application attribute: + ▸ provide the argument application on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The Cloud location for the application. + + To set the location attribute: + ▸ provide the argument application on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --business-owners=[channel-uri=CHANNEL-URI],[display-name=DISPLAY-NAME],[email=EMAIL] + Business owners of the Application + + --criticality=[level=LEVEL],[mission-critical=MISSION-CRITICAL] + Criticality of the Application + + --description=DESCRIPTION + Description of the Application + + --developer-owners=[channel-uri=CHANNEL-URI],[display-name=DISPLAY-NAME],[email=EMAIL] + Developer owners of the Application + + --display-name=DISPLAY_NAME + Human-friendly display name + + --environment=ENVIRONMENT + Environment of the Application + + --operator-owners=[channel-uri=CHANNEL-URI],[display-name=DISPLAY-NAME],[email=EMAIL] + Operator owners of the Application + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --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/apphub/applications/workloads/create b/gcloud/alpha/apphub/applications/workloads/create new file mode 100644 index 000000000..e5a940eb1 --- /dev/null +++ b/gcloud/alpha/apphub/applications/workloads/create @@ -0,0 +1,132 @@ +NAME + gcloud alpha apphub applications workloads create - create an Apphub + application workload + +SYNOPSIS + gcloud alpha apphub applications workloads create + (WORKLOAD : --application=APPLICATION --location=LOCATION) + --discovered-workload=DISCOVERED_WORKLOAD [--async] + [--business-owners=[channel-uri=CHANNEL-URI], + [display-name=DISPLAY-NAME],[email=EMAIL]] + [--criticality=[level=LEVEL],[mission-critical=MISSION-CRITICAL]] + [--description=DESCRIPTION] + [--developer-owners=[channel-uri=CHANNEL-URI], + [display-name=DISPLAY-NAME],[email=EMAIL]] + [--display-name=DISPLAY_NAME] [--environment=ENVIRONMENT] + [--operator-owners=[channel-uri=CHANNEL-URI], + [display-name=DISPLAY-NAME],[email=EMAIL]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create an Apphub application workload. + +EXAMPLES + To create the Workload my-workload with discovered workload + my-discovered-workload in the Application my-app in location us-east1, run: + + $ gcloud alpha apphub applications workloads create my-workload \ + --application=my-app --location=us-east1 \ + --discovered-workload=my-discovered-workload + +POSITIONAL ARGUMENTS + Workload resource - The Workload 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 WORKLOAD 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. + + WORKLOAD + ID of the workload or fully qualified identifier for the workload. + + To set the workload attribute: + ▸ provide the argument WORKLOAD on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --application=APPLICATION + Name for the application + + To set the application attribute: + ▸ provide the argument WORKLOAD on the command line with a fully + specified name; + ▸ provide the argument --application on the command line. + + --location=LOCATION + The Cloud location for the workload. + + To set the location attribute: + ▸ provide the argument WORKLOAD on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + DiscoveredWorkload resource - The discovered workload 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 --discovered-workload on the command line with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument --discovered-workload on the command line with a + fully specified name; + ◆ provide the argument --location on the command line. + + This must be specified. + + --discovered-workload=DISCOVERED_WORKLOAD + ID of the discoveredWorkload or fully qualified identifier for the + discoveredWorkload. + + To set the discovered_workload attribute: + ▸ provide the argument --discovered-workload on the command line. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --business-owners=[channel-uri=CHANNEL-URI],[display-name=DISPLAY-NAME],[email=EMAIL] + Business owners of the workload + + --criticality=[level=LEVEL],[mission-critical=MISSION-CRITICAL] + Criticality of the workload + + --description=DESCRIPTION + Description of the Workload + + --developer-owners=[channel-uri=CHANNEL-URI],[display-name=DISPLAY-NAME],[email=EMAIL] + Developer owners of the workload + + --display-name=DISPLAY_NAME + Human-friendly display name + + --environment=ENVIRONMENT + Environment of the workload + + --operator-owners=[channel-uri=CHANNEL-URI],[display-name=DISPLAY-NAME],[email=EMAIL] + Operator owners of the workload + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --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/apphub/applications/workloads/delete b/gcloud/alpha/apphub/applications/workloads/delete new file mode 100644 index 000000000..8137e00ca --- /dev/null +++ b/gcloud/alpha/apphub/applications/workloads/delete @@ -0,0 +1,76 @@ +NAME + gcloud alpha apphub applications workloads delete - delete an Apphub + application workload + +SYNOPSIS + gcloud alpha apphub applications workloads delete + (WORKLOAD : --application=APPLICATION --location=LOCATION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete an Apphub application workload. + +EXAMPLES + To delete the Workload my-workload from the Application my-app in location + us-east1, run: + + $ gcloud alpha apphub applications workloads delete my-workload \ + --application=my-app --location=us-east1 + +POSITIONAL ARGUMENTS + Workload resource - The Workload ID. The arguments in this group can be + used to specify the attributes of 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 workload 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. + + WORKLOAD + ID of the workload or fully qualified identifier for the workload. + + To set the workload attribute: + ▸ provide the argument workload on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --application=APPLICATION + Name for the application + + To set the application attribute: + ▸ provide the argument workload on the command line with a fully + specified name; + ▸ provide the argument --application on the command line. + + --location=LOCATION + The Cloud location for the workload. + + To set the location attribute: + ▸ provide the argument workload on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails 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/apphub/applications/workloads/describe b/gcloud/alpha/apphub/applications/workloads/describe new file mode 100644 index 000000000..636523e32 --- /dev/null +++ b/gcloud/alpha/apphub/applications/workloads/describe @@ -0,0 +1,71 @@ +NAME + gcloud alpha apphub applications workloads describe - describe an Apphub + application workload + +SYNOPSIS + gcloud alpha apphub applications workloads describe + (WORKLOAD : --application=APPLICATION --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe an Apphub application workload. + +EXAMPLES + To describe the Workload my-workload in the Application my-app in location + us-east1, run: + + $ gcloud alpha apphub applications workloads describe my-workload \ + --application=my-app --location=us-east1 + +POSITIONAL ARGUMENTS + Workload resource - The Workload ID. The arguments in this group can be + used to specify the attributes of 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 workload 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. + + WORKLOAD + ID of the workload or fully qualified identifier for the workload. + + To set the workload attribute: + ▸ provide the argument workload on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --application=APPLICATION + Name for the application + + To set the application attribute: + ▸ provide the argument workload on the command line with a fully + specified name; + ▸ provide the argument --application on the command line. + + --location=LOCATION + The Cloud location for the workload. + + To set the location attribute: + ▸ provide the argument workload 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. + diff --git a/gcloud/alpha/apphub/applications/workloads/help b/gcloud/alpha/apphub/applications/workloads/help new file mode 100644 index 000000000..83bd20861 --- /dev/null +++ b/gcloud/alpha/apphub/applications/workloads/help @@ -0,0 +1,39 @@ +NAME + gcloud alpha apphub applications workloads - manage App Hub Application + Workloads + +SYNOPSIS + gcloud alpha apphub applications workloads COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Commands for managing App Hub Application Workloads. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Create an Apphub application workload. + + delete + (ALPHA) Delete an Apphub application workload. + + describe + (ALPHA) Describe an Apphub application workload. + + list + (ALPHA) List Apphub application workloads. + + update + (ALPHA) Update an Apphub application workload. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails 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/apphub/applications/workloads/list b/gcloud/alpha/apphub/applications/workloads/list new file mode 100644 index 000000000..ada872e81 --- /dev/null +++ b/gcloud/alpha/apphub/applications/workloads/list @@ -0,0 +1,96 @@ +NAME + gcloud alpha apphub applications workloads list - list Apphub application + workloads + +SYNOPSIS + gcloud alpha apphub applications workloads list + (--application=APPLICATION : --location=LOCATION) [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List Apphub application workloads. + +EXAMPLES + To list all Workloads in the Application my-app in location us-east1, run: + + $ gcloud alpha apphub applications workloads list \ + --application=my-app --location=us-east1 + +REQUIRED FLAGS + Application resource - The Application ID. The arguments in this group can + be used to specify the attributes of 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 --application 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. + + --application=APPLICATION + ID of the application or fully qualified identifier for the + application. + + To set the application attribute: + ▸ provide the argument --application on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The Cloud location for the application. + + To set the location attribute: + ▸ provide the argument --application 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. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/apphub/applications/workloads/update b/gcloud/alpha/apphub/applications/workloads/update new file mode 100644 index 000000000..68f5bce23 --- /dev/null +++ b/gcloud/alpha/apphub/applications/workloads/update @@ -0,0 +1,105 @@ +NAME + gcloud alpha apphub applications workloads update - update an Apphub + application workload + +SYNOPSIS + gcloud alpha apphub applications workloads update + (WORKLOAD : --application=APPLICATION --location=LOCATION) [--async] + [--business-owners=[channel-uri=CHANNEL-URI], + [display-name=DISPLAY-NAME],[email=EMAIL]] + [--criticality=[level=LEVEL],[mission-critical=MISSION-CRITICAL]] + [--description=DESCRIPTION] + [--developer-owners=[channel-uri=CHANNEL-URI], + [display-name=DISPLAY-NAME],[email=EMAIL]] + [--display-name=DISPLAY_NAME] [--environment=ENVIRONMENT] + [--operator-owners=[channel-uri=CHANNEL-URI], + [display-name=DISPLAY-NAME],[email=EMAIL]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Update an Apphub application workload. + +EXAMPLES + To update the Workload my-workload with a new environment prod in the + Application my-app in location us-east1, run: + + $ gcloud alpha apphub applications workloads update my-workload \ + --environment=prod --application=my-app --location=us-east1 + +POSITIONAL ARGUMENTS + Workload resource - The Workload ID. The arguments in this group can be + used to specify the attributes of 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 workload 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. + + WORKLOAD + ID of the workload or fully qualified identifier for the workload. + + To set the workload attribute: + ▸ provide the argument workload on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --application=APPLICATION + Name for the application + + To set the application attribute: + ▸ provide the argument workload on the command line with a fully + specified name; + ▸ provide the argument --application on the command line. + + --location=LOCATION + The Cloud location for the workload. + + To set the location attribute: + ▸ provide the argument workload on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --business-owners=[channel-uri=CHANNEL-URI],[display-name=DISPLAY-NAME],[email=EMAIL] + Business owners of the workload + + --criticality=[level=LEVEL],[mission-critical=MISSION-CRITICAL] + Criticality of the workload + + --description=DESCRIPTION + Description of the Workload + + --developer-owners=[channel-uri=CHANNEL-URI],[display-name=DISPLAY-NAME],[email=EMAIL] + Developer owners of the workload + + --display-name=DISPLAY_NAME + Human-friendly display name + + --environment=ENVIRONMENT + Environment of the workload + + --operator-owners=[channel-uri=CHANNEL-URI],[display-name=DISPLAY-NAME],[email=EMAIL] + Operator owners of the workload + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --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/apphub/discovered-services/describe b/gcloud/alpha/apphub/discovered-services/describe new file mode 100644 index 000000000..89753eb56 --- /dev/null +++ b/gcloud/alpha/apphub/discovered-services/describe @@ -0,0 +1,64 @@ +NAME + gcloud alpha apphub discovered-services describe - describe an Apphub + discovered service + +SYNOPSIS + gcloud alpha apphub discovered-services describe + (DISCOVERED_SERVICE : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe an Apphub discovered service. + +EXAMPLES + To describe the DiscoveredService my-discovered-service in location + us-east1, run: + + $ gcloud alpha apphub discovered-services describe \ + my-discovered-service --location=us-east1 + +POSITIONAL ARGUMENTS + DiscoveredService resource - The Discovered Service ID. The arguments in + this group can be used to specify the attributes of 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 discovered_service 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. + + DISCOVERED_SERVICE + ID of the discoveredService or fully qualified identifier for the + discoveredService. + + To set the discovered_service attribute: + ▸ provide the argument discovered_service on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The Cloud location for the discoveredService. + + To set the location attribute: + ▸ provide the argument discovered_service 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. + diff --git a/gcloud/alpha/apphub/discovered-services/find-unregistered b/gcloud/alpha/apphub/discovered-services/find-unregistered new file mode 100644 index 000000000..841985510 --- /dev/null +++ b/gcloud/alpha/apphub/discovered-services/find-unregistered @@ -0,0 +1,84 @@ +NAME + gcloud alpha apphub discovered-services find-unregistered - list + unregistered Apphub discovered services + +SYNOPSIS + gcloud alpha apphub discovered-services find-unregistered + --location=LOCATION [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List unregistered Apphub discovered services. + +EXAMPLES + To list all unregistered DiscoveredServices in location us-east1, run: + + $ gcloud alpha apphub discovered-services find-unregistered \ + --location=us-east1 + +REQUIRED FLAGS + Location resource - Location. 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=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails 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/apphub/discovered-services/help b/gcloud/alpha/apphub/discovered-services/help new file mode 100644 index 000000000..a1315a5ff --- /dev/null +++ b/gcloud/alpha/apphub/discovered-services/help @@ -0,0 +1,33 @@ +NAME + gcloud alpha apphub discovered-services - manage App Hub Discovered + Services + +SYNOPSIS + gcloud alpha apphub discovered-services COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Commands for managing App Hub Discovered Services. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + (ALPHA) Describe an Apphub discovered service. + + find-unregistered + (ALPHA) List unregistered Apphub discovered services. + + list + (ALPHA) List Apphub discovered services. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails 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/apphub/discovered-services/list b/gcloud/alpha/apphub/discovered-services/list new file mode 100644 index 000000000..b6265f3bb --- /dev/null +++ b/gcloud/alpha/apphub/discovered-services/list @@ -0,0 +1,82 @@ +NAME + gcloud alpha apphub discovered-services list - list Apphub discovered + services + +SYNOPSIS + gcloud alpha apphub discovered-services list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List Apphub discovered services. + +EXAMPLES + To list all DiscoveredServices in location us-east1, run: + + $ gcloud alpha apphub discovered-services list --location=us-east1 + +REQUIRED FLAGS + Location resource - Location. 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=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails 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/apphub/discovered-workloads/describe b/gcloud/alpha/apphub/discovered-workloads/describe new file mode 100644 index 000000000..e7ded3b69 --- /dev/null +++ b/gcloud/alpha/apphub/discovered-workloads/describe @@ -0,0 +1,64 @@ +NAME + gcloud alpha apphub discovered-workloads describe - describe an Apphub + discovered workload + +SYNOPSIS + gcloud alpha apphub discovered-workloads describe + (DISCOVERED_WORKLOAD : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe an Apphub discovered workload. + +EXAMPLES + To describe the DiscoveredWorkload my-discovered-workload in location + us-east1, run: + + $ gcloud alpha apphub discovered-workloads describe \ + my-discovered-workload --location=us-east1 + +POSITIONAL ARGUMENTS + DiscoveredWorkload resource - The Discovered Workload ID. The arguments in + this group can be used to specify the attributes of 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 discovered_workload 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. + + DISCOVERED_WORKLOAD + ID of the discoveredWorkload or fully qualified identifier for the + discoveredWorkload. + + To set the discovered_workload attribute: + ▸ provide the argument discovered_workload on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The Cloud location for the discoveredWorkload. + + To set the location attribute: + ▸ provide the argument discovered_workload 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. + diff --git a/gcloud/alpha/apphub/discovered-workloads/find-unregistered b/gcloud/alpha/apphub/discovered-workloads/find-unregistered new file mode 100644 index 000000000..de5a6d56f --- /dev/null +++ b/gcloud/alpha/apphub/discovered-workloads/find-unregistered @@ -0,0 +1,84 @@ +NAME + gcloud alpha apphub discovered-workloads find-unregistered - list + unregistered Apphub discovered workloads + +SYNOPSIS + gcloud alpha apphub discovered-workloads find-unregistered + --location=LOCATION [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List unregistered Apphub discovered workloads. + +EXAMPLES + To list all unregistered DiscoveredWorkloads in location us-east1, run: + + $ gcloud alpha apphub discovered-workloads find-unregistered \ + --location=us-east1 + +REQUIRED FLAGS + Location resource - Location. 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=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails 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/apphub/discovered-workloads/help b/gcloud/alpha/apphub/discovered-workloads/help new file mode 100644 index 000000000..48370a266 --- /dev/null +++ b/gcloud/alpha/apphub/discovered-workloads/help @@ -0,0 +1,33 @@ +NAME + gcloud alpha apphub discovered-workloads - manage App Hub Discovered + Workloads + +SYNOPSIS + gcloud alpha apphub discovered-workloads COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Commands for managing App Hub Discovered Workloads. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + (ALPHA) Describe an Apphub discovered workload. + + find-unregistered + (ALPHA) List unregistered Apphub discovered workloads. + + list + (ALPHA) List Apphub discovered workloads. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails 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/apphub/discovered-workloads/list b/gcloud/alpha/apphub/discovered-workloads/list new file mode 100644 index 000000000..18a4c985e --- /dev/null +++ b/gcloud/alpha/apphub/discovered-workloads/list @@ -0,0 +1,82 @@ +NAME + gcloud alpha apphub discovered-workloads list - list Apphub discovered + workloads + +SYNOPSIS + gcloud alpha apphub discovered-workloads list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List Apphub discovered workloads. + +EXAMPLES + To list all DiscoveredWorkloads in location us-east1, run: + + $ gcloud alpha apphub discovered-workloads list --location=us-east1 + +REQUIRED FLAGS + Location resource - Location. 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=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails 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/apphub/help b/gcloud/alpha/apphub/help new file mode 100644 index 000000000..0eb394824 --- /dev/null +++ b/gcloud/alpha/apphub/help @@ -0,0 +1,38 @@ +NAME + gcloud alpha apphub - manage App Hub resources + +SYNOPSIS + gcloud alpha apphub GROUP [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage App Hub resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + applications + (ALPHA) Manage App Hub Applications. + + discovered-services + (ALPHA) Manage App Hub Discovered Services. + + discovered-workloads + (ALPHA) Manage App Hub Discovered Workloads. + + operations + (ALPHA) Manage App Hub Operations (long-running operations). + + service-projects + (ALPHA) Manage App Hub Service Projects. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails 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/apphub/operations/describe b/gcloud/alpha/apphub/operations/describe new file mode 100644 index 000000000..fd33545c9 --- /dev/null +++ b/gcloud/alpha/apphub/operations/describe @@ -0,0 +1,60 @@ +NAME + gcloud alpha apphub operations describe - describe an Apphub operation + (long-running operation) + +SYNOPSIS + gcloud alpha apphub operations describe (OPERATION : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe an Apphub operation (long-running operation). + +EXAMPLES + To describe a specific apphub operation with the name my-operation, run: + + $ gcloud alpha apphub operations describe my-operation + +POSITIONAL ARGUMENTS + Operation resource - The Operation ID. The arguments in this group can be + used to specify the attributes of 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; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + OPERATION + ID of the operation or fully qualified identifier for the operation. + + To set the operation attribute: + ▸ provide the argument operation on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The Cloud location for the operation. + + To set the location attribute: + ▸ provide the argument operation on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails 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/apphub/operations/help b/gcloud/alpha/apphub/operations/help new file mode 100644 index 000000000..c98aebb3e --- /dev/null +++ b/gcloud/alpha/apphub/operations/help @@ -0,0 +1,30 @@ +NAME + gcloud alpha apphub operations - manage App Hub Operations + (long-running operations) + +SYNOPSIS + gcloud alpha apphub operations COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Commands for managing App Hub Operations (long-running operations). + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + (ALPHA) Describe an Apphub operation (long-running operation). + + list + (ALPHA) List Apphub operations (long-running operations). + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/apphub/operations/list b/gcloud/alpha/apphub/operations/list new file mode 100644 index 000000000..fd4f4a77c --- /dev/null +++ b/gcloud/alpha/apphub/operations/list @@ -0,0 +1,82 @@ +NAME + gcloud alpha apphub operations list - list Apphub operations + (long-running operations) + +SYNOPSIS + gcloud alpha apphub operations list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List Apphub operations (long-running operations). + +EXAMPLES + To list all operations, run: + + $ gcloud alpha apphub operations list + +REQUIRED FLAGS + Location resource - Location. 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=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails 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/apphub/service-projects/add b/gcloud/alpha/apphub/service-projects/add new file mode 100644 index 000000000..ba735bad2 --- /dev/null +++ b/gcloud/alpha/apphub/service-projects/add @@ -0,0 +1,70 @@ +NAME + gcloud alpha apphub service-projects add - add an Apphub service project + +SYNOPSIS + gcloud alpha apphub service-projects add + (SERVICE_PROJECT : --location=LOCATION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Add an Apphub service project. + +EXAMPLES + To add the service project my-service-project to the host project + my-host-project, run: + + $ gcloud alpha apphub service-projects add my-service-project \ + --project=my-host-project + +POSITIONAL ARGUMENTS + ServiceProjectAttachment resource - The Service Project ID. The arguments + in this group can be used to specify the attributes of 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 service_project 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. + + SERVICE_PROJECT + ID of the ServiceProjectAttachment or fully qualified identifier for + the ServiceProjectAttachment. + + To set the service_project attribute: + ▸ provide the argument service_project on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location of the ServiceProjectAttachment. + + To set the location attribute: + ▸ provide the argument service_project on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ Service project attachments only support global location. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails 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/apphub/service-projects/describe b/gcloud/alpha/apphub/service-projects/describe new file mode 100644 index 000000000..f5590993d --- /dev/null +++ b/gcloud/alpha/apphub/service-projects/describe @@ -0,0 +1,65 @@ +NAME + gcloud alpha apphub service-projects describe - describe an Apphub service + project + +SYNOPSIS + gcloud alpha apphub service-projects describe + (SERVICE_PROJECT : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe an Apphub service project. + +EXAMPLES + To describe the service project my-service-project attached to the host + project my-host-project, run: + + $ gcloud alpha apphub service-projects describe my-service-project \ + --project=my-host-project + +POSITIONAL ARGUMENTS + ServiceProjectAttachment resource - The Service Project ID. The arguments + in this group can be used to specify the attributes of 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 service_project 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. + + SERVICE_PROJECT + ID of the ServiceProjectAttachment or fully qualified identifier for + the ServiceProjectAttachment. + + To set the service_project attribute: + ▸ provide the argument service_project on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location of the ServiceProjectAttachment. + + To set the location attribute: + ▸ provide the argument service_project on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ Service project attachments only support global location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/apphub/service-projects/detach b/gcloud/alpha/apphub/service-projects/detach new file mode 100644 index 000000000..b8bf61ea1 --- /dev/null +++ b/gcloud/alpha/apphub/service-projects/detach @@ -0,0 +1,30 @@ +NAME + gcloud alpha apphub service-projects detach - detach an Apphub service + project + +SYNOPSIS + gcloud alpha apphub service-projects detach [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Detach an Apphub service project. + +EXAMPLES + To detach the service project my-service-project, run: + + $ gcloud alpha apphub service-projects detach \ + --project=my-service-project + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --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/apphub/service-projects/help b/gcloud/alpha/apphub/service-projects/help new file mode 100644 index 000000000..e2df0cc00 --- /dev/null +++ b/gcloud/alpha/apphub/service-projects/help @@ -0,0 +1,41 @@ +NAME + gcloud alpha apphub service-projects - manage App Hub Service Projects + +SYNOPSIS + gcloud alpha apphub service-projects COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Commands for managing App Hub Service Projects. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + add + (ALPHA) Add an Apphub service project. + + describe + (ALPHA) Describe an Apphub service project. + + detach + (ALPHA) Detach an Apphub service project. + + list + (ALPHA) List Apphub service projects. + + lookup + (ALPHA) Lookup an Apphub service project. + + remove + (ALPHA) Remove an Apphub service project. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails 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/apphub/service-projects/list b/gcloud/alpha/apphub/service-projects/list new file mode 100644 index 000000000..594128267 --- /dev/null +++ b/gcloud/alpha/apphub/service-projects/list @@ -0,0 +1,83 @@ +NAME + gcloud alpha apphub service-projects list - list Apphub service projects + +SYNOPSIS + gcloud alpha apphub service-projects list [--location=LOCATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List Apphub service projects. + +EXAMPLES + To list all service projects attached to the host project my-host-project, + run: + + $ gcloud alpha apphub service-projects list --project=my-host-project + +FLAGS + Location resource - Location. 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; + ◆ Service project attachments only support global location with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line; + ▸ Service project attachments only support global location. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails 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/apphub/service-projects/lookup b/gcloud/alpha/apphub/service-projects/lookup new file mode 100644 index 000000000..fc864d247 --- /dev/null +++ b/gcloud/alpha/apphub/service-projects/lookup @@ -0,0 +1,30 @@ +NAME + gcloud alpha apphub service-projects lookup - lookup an Apphub service + project + +SYNOPSIS + gcloud alpha apphub service-projects lookup [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Lookup an Apphub service project. + +EXAMPLES + To lookup the service project my-service-project, run: + + $ gcloud alpha apphub service-projects lookup \ + --project=my-service-project + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --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/apphub/service-projects/remove b/gcloud/alpha/apphub/service-projects/remove new file mode 100644 index 000000000..cf53fcd77 --- /dev/null +++ b/gcloud/alpha/apphub/service-projects/remove @@ -0,0 +1,71 @@ +NAME + gcloud alpha apphub service-projects remove - remove an Apphub service + project + +SYNOPSIS + gcloud alpha apphub service-projects remove + (SERVICE_PROJECT : --location=LOCATION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Remove an Apphub service project. + +EXAMPLES + To remove the service project my-service-project from the host project + my-host-project, run: + + $ gcloud alpha apphub service-projects remove my-service-project \ + --project=my-host-project + +POSITIONAL ARGUMENTS + ServiceProjectAttachment resource - The Service Project ID. The arguments + in this group can be used to specify the attributes of 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 service_project 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. + + SERVICE_PROJECT + ID of the ServiceProjectAttachment or fully qualified identifier for + the ServiceProjectAttachment. + + To set the service_project attribute: + ▸ provide the argument service_project on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location of the ServiceProjectAttachment. + + To set the location attribute: + ▸ provide the argument service_project on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ Service project attachments only support global location. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails 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/backup-dr/help b/gcloud/alpha/backup-dr/help index e7c6f854b..2032c28c6 100644 --- a/gcloud/alpha/backup-dr/help +++ b/gcloud/alpha/backup-dr/help @@ -1,11 +1,11 @@ NAME - gcloud alpha backup-dr - backup and DR command group + gcloud alpha backup-dr - manage Backup and DR resources SYNOPSIS gcloud alpha backup-dr GROUP [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Backup and DR command group. + (ALPHA) Manage Backup and DR resources. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -28,5 +28,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. These variants are also available: + + $ gcloud backup-dr + + $ gcloud beta backup-dr diff --git a/gcloud/alpha/backup-dr/locations/help b/gcloud/alpha/backup-dr/locations/help index d67aeb425..c46b6bc3c 100644 --- a/gcloud/alpha/backup-dr/locations/help +++ b/gcloud/alpha/backup-dr/locations/help @@ -22,5 +22,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. These variants are also available: + + $ gcloud backup-dr locations + + $ gcloud beta backup-dr locations diff --git a/gcloud/alpha/backup-dr/locations/list b/gcloud/alpha/backup-dr/locations/list index 822d6d2d0..d7ee2be95 100644 --- a/gcloud/alpha/backup-dr/locations/list +++ b/gcloud/alpha/backup-dr/locations/list @@ -8,7 +8,7 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) List available Backup and DR locations. + (ALPHA) List all locations where Backup and DR Service is available. EXAMPLES To list all locations, run: @@ -63,5 +63,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. These variants are also available: + + $ gcloud backup-dr locations list + + $ gcloud beta backup-dr locations list diff --git a/gcloud/alpha/backup-dr/management-servers/create b/gcloud/alpha/backup-dr/management-servers/create index 7676827da..2a6c6953d 100644 --- a/gcloud/alpha/backup-dr/management-servers/create +++ b/gcloud/alpha/backup-dr/management-servers/create @@ -1,6 +1,6 @@ NAME - gcloud alpha backup-dr management-servers create - create a new Management - Server + gcloud alpha backup-dr management-servers create - create a new management + server in the project SYNOPSIS gcloud alpha backup-dr management-servers create @@ -8,7 +8,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Create a new Management Server. + (ALPHA) Create a new management server in the project. A management server + is required to access the management console. It can only be created in + locations where Backup and DR is available. Resources in other locations + can be backed up. EXAMPLES To create a new management server sample-ms in project sample-project and @@ -19,10 +22,12 @@ EXAMPLES --network=projects/sample-project/global/networks/sample-network POSITIONAL ARGUMENTS - Management Server resource - Management Server to create. The arguments in - this group can be used to specify the attributes of this resource. (NOTE) - Some attributes are not given arguments in this group but can be set in - other ways. + Management Server resource - Name of the management server to be created. + Once the management server is deployed, this name can't be changed. The + name must be unique for a project and location. The arguments in this + group can be used to specify the attributes of 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 management_server on the command line with a @@ -74,9 +79,16 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. +BRIEF + Creates a new management server + NOTES This command is currently in alpha and might change without notice. If this command fails 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. These variants are also available: + + $ gcloud backup-dr management-servers create + + $ gcloud beta backup-dr management-servers create diff --git a/gcloud/alpha/backup-dr/management-servers/delete b/gcloud/alpha/backup-dr/management-servers/delete index 747d8dbc8..36fa6c0ef 100644 --- a/gcloud/alpha/backup-dr/management-servers/delete +++ b/gcloud/alpha/backup-dr/management-servers/delete @@ -1,5 +1,5 @@ NAME - gcloud alpha backup-dr management-servers delete - delete a given + gcloud alpha backup-dr management-servers delete - delete the specified Management Server SYNOPSIS @@ -8,7 +8,7 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Delete a given Management Server. + (ALPHA) Delete the specified Management Server. EXAMPLES To delete a management server sample-ms in project sample-project and @@ -18,10 +18,12 @@ EXAMPLES --project=sample-project --location=us-central1 POSITIONAL ARGUMENTS - Management Server resource - Management Server to delete. The arguments in - this group can be used to specify the attributes of this resource. (NOTE) - Some attributes are not given arguments in this group but can be set in - other ways. + Management Server resource - Name of the management server to delete. + Before you delete, take a look at the prerequisites here + (https://cloud.google.com/backup-disaster-recovery/docs/configuration/decommission). + The arguments in this group can be used to specify the attributes of 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 management_server on the command line with a @@ -63,9 +65,16 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. +BRIEF + Deletes a specific management server + NOTES This command is currently in alpha and might change without notice. If this command fails 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. These variants are also available: + + $ gcloud backup-dr management-servers delete + + $ gcloud beta backup-dr management-servers delete diff --git a/gcloud/alpha/backup-dr/management-servers/describe b/gcloud/alpha/backup-dr/management-servers/describe index f6459092c..8edc3511f 100644 --- a/gcloud/alpha/backup-dr/management-servers/describe +++ b/gcloud/alpha/backup-dr/management-servers/describe @@ -1,13 +1,14 @@ NAME - gcloud alpha backup-dr management-servers describe - describe a management - server + gcloud alpha backup-dr management-servers describe - show details of the + management server SYNOPSIS gcloud alpha backup-dr management-servers describe (MANAGEMENT_SERVER : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Describe a management server. + (ALPHA) Show all configuration data associated with the specified + management server. EXAMPLES To view details for management server 'MANAGEMENT_SERVER', run: @@ -16,10 +17,10 @@ EXAMPLES MANAGEMENT_SERVER POSITIONAL ARGUMENTS - ManagementServer resource - Management Server 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. + ManagementServer resource - Name of the management server 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 management_server on the command line with a @@ -63,5 +64,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. These variants are also available: + + $ gcloud backup-dr management-servers describe + + $ gcloud beta backup-dr management-servers describe diff --git a/gcloud/alpha/backup-dr/management-servers/help b/gcloud/alpha/backup-dr/management-servers/help index db04b252d..26077cabe 100644 --- a/gcloud/alpha/backup-dr/management-servers/help +++ b/gcloud/alpha/backup-dr/management-servers/help @@ -17,20 +17,24 @@ COMMANDS COMMAND is one of the following: create - (ALPHA) Create a new Management Server. + (ALPHA) Create a new management server in the project. delete - (ALPHA) Delete a given Management Server. + (ALPHA) Delete the specified Management Server. describe - (ALPHA) Describe a management server. + (ALPHA) Show details of the management server. list - (ALPHA) List Management Servers. + (ALPHA) List management servers in the project. NOTES This command is currently in alpha and might change without notice. If this command fails 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. These variants are also available: + + $ gcloud backup-dr management-servers + + $ gcloud beta backup-dr management-servers diff --git a/gcloud/alpha/backup-dr/management-servers/list b/gcloud/alpha/backup-dr/management-servers/list index e0e6acba4..6189c9612 100644 --- a/gcloud/alpha/backup-dr/management-servers/list +++ b/gcloud/alpha/backup-dr/management-servers/list @@ -1,5 +1,6 @@ NAME - gcloud alpha backup-dr management-servers list - list Management Servers + gcloud alpha backup-dr management-servers list - list management servers in + the project SYNOPSIS gcloud alpha backup-dr management-servers list [--location=LOCATION] @@ -7,22 +8,23 @@ SYNOPSIS [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Displays all managment servers in a project. + (ALPHA) List management servers in the project. Currently, a project can + have only one management server. EXAMPLES To list management servers for all locations, run: $ gcloud alpha backup-dr management-servers list - To list all management servers in a location my-location, run: + To list management servers in a location my-location, run: $ gcloud alpha backup-dr management-servers list \ --location=my-location FLAGS - Location resource - Location to list management servers from. This - represents a Cloud resource. (NOTE) Some attributes are not given - arguments in this group but can be set in other ways. + Location resource - Location for which management servers should be + listed. 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 @@ -86,5 +88,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. These variants are also available: + + $ gcloud backup-dr management-servers list + + $ gcloud beta backup-dr management-servers list diff --git a/gcloud/alpha/backup-dr/operations/describe b/gcloud/alpha/backup-dr/operations/describe index 27661adc5..a726f1731 100644 --- a/gcloud/alpha/backup-dr/operations/describe +++ b/gcloud/alpha/backup-dr/operations/describe @@ -1,6 +1,5 @@ NAME - gcloud alpha backup-dr operations describe - describe a Backup and DR - operation + gcloud alpha backup-dr operations describe - describe an operation SYNOPSIS gcloud alpha backup-dr operations describe @@ -61,5 +60,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. These variants are also available: + + $ gcloud backup-dr operations describe + + $ gcloud beta backup-dr operations describe diff --git a/gcloud/alpha/backup-dr/operations/help b/gcloud/alpha/backup-dr/operations/help index 53bda03f4..88ec181d6 100644 --- a/gcloud/alpha/backup-dr/operations/help +++ b/gcloud/alpha/backup-dr/operations/help @@ -16,14 +16,18 @@ COMMANDS COMMAND is one of the following: describe - (ALPHA) Describe a Backup and DR operation. + (ALPHA) Describe an operation. list - (ALPHA) List Backup and DR operations. + (ALPHA) List all operations. NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. These variants are also available: + + $ gcloud backup-dr operations + + $ gcloud beta backup-dr operations diff --git a/gcloud/alpha/backup-dr/operations/list b/gcloud/alpha/backup-dr/operations/list index 82713b932..e73373fd7 100644 --- a/gcloud/alpha/backup-dr/operations/list +++ b/gcloud/alpha/backup-dr/operations/list @@ -1,5 +1,5 @@ NAME - gcloud alpha backup-dr operations list - list Backup and DR operations + gcloud alpha backup-dr operations list - list all operations SYNOPSIS gcloud alpha backup-dr operations list --location=LOCATION @@ -7,7 +7,7 @@ SYNOPSIS [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) List Backup and DR operations. + (ALPHA) List all Backup and DR operations. EXAMPLES To list all operations in a location my-location, run: @@ -19,9 +19,9 @@ EXAMPLES $ gcloud alpha backup-dr operations list --location=- REQUIRED FLAGS - Location resource - Location to list operations from. This represents a - Cloud resource. (NOTE) Some attributes are not given arguments in this - group but can be set in other ways. + Location resource - Location for which operations should be listed. 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 @@ -85,5 +85,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. These variants are also available: + + $ gcloud backup-dr operations list + + $ gcloud beta backup-dr operations list diff --git a/gcloud/alpha/blockchain-node-engine/nodes/create b/gcloud/alpha/blockchain-node-engine/nodes/create index 43e323f0d..d6210a2fd 100644 --- a/gcloud/alpha/blockchain-node-engine/nodes/create +++ b/gcloud/alpha/blockchain-node-engine/nodes/create @@ -91,9 +91,15 @@ FLAGS goerli Goerli & Prater Ethereum test network. + holesky + Holesky Ethereum test network. + mainnet Primary Ethereum network, often referred to as mainnet. + sepolia + Sepolia Ethereum test network. + --node-type=NODE_TYPE; default="FULL" Node type - defines whether the node retains only recent data or an archival history. NODE_TYPE must be (only one value is supported): diff --git a/gcloud/alpha/bms/instances/update b/gcloud/alpha/bms/instances/update index 7a6826f9d..f155ad146 100644 --- a/gcloud/alpha/bms/instances/update +++ b/gcloud/alpha/bms/instances/update @@ -5,8 +5,9 @@ SYNOPSIS gcloud alpha bms instances update (INSTANCE : --region=REGION) [--async] [--[no-]enable-hyperthreading] [--kms-crypto-key-version=KMS_CRYPTO_KEY_VERSION] [--os-image=OS_IMAGE] - [--ssh-keys=[SSH_KEYS,...]] [--update-labels=[KEY=VALUE,...]] - [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + [--update-labels=[KEY=VALUE,...]] + [--clear-labels | --remove-labels=[KEY,...]] + [--clear-ssh-keys | --ssh-keys=[SSH_KEYS,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Update a Bare Metal Solution instance. @@ -75,27 +76,6 @@ FLAGS --os-image=OS_IMAGE OS image to install on the server. - SSH key resource - ssh_key. 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 --ssh-keys on the command line with a fully - specified name; - ◆ set the property core/project; - ◆ provide the argument --project on the command line. - - To set the region attribute: - ◆ provide the argument --ssh-keys on the command line with a fully - specified name; - ◆ global is the only supported location. - - --ssh-keys=[SSH_KEYS,...] - IDs of the SSH keys or fully qualified identifiers for the SSH keys. - - To set the ssh_key attribute: - ▸ provide the argument --ssh-keys on the command line. - --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. @@ -125,6 +105,33 @@ FLAGS silently ignored. If --update-labels is also specified then --update-labels is applied first. + At most one of these can be specified: + + --clear-ssh-keys + Provisions the instance without any SSH keys. + + SSH key resource - ssh_key. 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 --ssh-keys on the command line with a fully + specified name; + ▸ set the property core/project; + ▸ provide the argument --project on the command line. + + To set the region attribute: + ▸ provide the argument --ssh-keys on the command line with a fully + specified name; + ▸ global is the only supported location. + + --ssh-keys=[SSH_KEYS,...] + IDs of the SSH keys or fully qualified identifiers for the SSH + keys. + + To set the ssh_key attribute: + ▫ provide the argument --ssh-keys on the command line. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/certificate-manager/trust-configs/create b/gcloud/alpha/certificate-manager/trust-configs/create new file mode 100644 index 000000000..69a640293 --- /dev/null +++ b/gcloud/alpha/certificate-manager/trust-configs/create @@ -0,0 +1,109 @@ +NAME + gcloud alpha certificate-manager trust-configs create - create TrustConfig + +SYNOPSIS + gcloud alpha certificate-manager trust-configs create + (TRUST_CONFIG : --location=LOCATION) + --trust-store=[intermediate-cas=INTERMEDIATE-CAS], + [trust-anchors=TRUST-ANCHORS] [--async] [--description=DESCRIPTION] + [--labels=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create a TrustConfig. + +EXAMPLES + To create a TrustConfig from PEM certificate files, run: + + $ gcloud alpha certificate-manager trust-configs create \ + my-trust-config --description="my description" \ + --labels=my-key1=my-value1,my-key2=my-value2 \ + --trust-store=trust-anchors=ta.pem,\ + intermediate-cas="ica1.pem;ica2.pem" + +POSITIONAL ARGUMENTS + TrustConfig resource - Name of the TrustConfig to create. The arguments in + this group can be used to specify the attributes of this resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. + + To set the project attribute: + ◆ provide the argument trust_config on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + TRUST_CONFIG + ID of the trustConfig or fully qualified identifier for the + trustConfig. + + To set the trust_config attribute: + ▸ provide the argument trust_config on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Certificate Manager location. + + To set the location attribute: + ▸ provide the argument trust_config on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ default value of location is [global]. + +REQUIRED FLAGS + --trust-store=[intermediate-cas=INTERMEDIATE-CAS],[trust-anchors=TRUST-ANCHORS] + Trust Store with the given trust anchor and intermediate CA PEM-encoded + certificates. Certificates should be provided in files. For multiple + file names, separate them by a semicolon (';') and quote them ('"'). + One file can contain multiple certificates. Intermediate CAs are + optional. + + Examples: + + Single files: --trust-store trust-anchors=ta.pem,intermediate-cas=ica.pem + + No intermediate CAs: --trust-store trust-anchors=ta.pem + + Multiple files: --trust-store trust-anchors="ta1.pem;ta2.pem",intermediate-cas="ica1.pem;ica2.pem" + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + Human-readable description of the resource. + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the certificatemanager/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/certificate-manager + +NOTES + This command is currently in alpha and might change without notice. If this + command fails 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 certificate-manager trust-configs create + + $ gcloud beta certificate-manager trust-configs create + diff --git a/gcloud/alpha/certificate-manager/trust-configs/help b/gcloud/alpha/certificate-manager/trust-configs/help index dfe82dcef..685681394 100644 --- a/gcloud/alpha/certificate-manager/trust-configs/help +++ b/gcloud/alpha/certificate-manager/trust-configs/help @@ -17,6 +17,9 @@ GCLOUD WIDE FLAGS COMMANDS COMMAND is one of the following: + create + (ALPHA) Create TrustConfig. + delete (ALPHA) Delete TrustConfig. diff --git a/gcloud/alpha/composer/environments/run b/gcloud/alpha/composer/environments/run index c1f7d9479..bddf79418 100644 --- a/gcloud/alpha/composer/environments/run +++ b/gcloud/alpha/composer/environments/run @@ -83,15 +83,15 @@ POSITIONAL ARGUMENTS (listed with Airflow versions that support): backfill [**, 2.0.0), clear [**, 2.0.0), connections [**, 3.0.0), dag_state [**, 2.0.0), dags [1.10.14, 3.0.0), db [2.3.0, 3.0.0), delete_dag [1.10.1, 2.0.0), - kerberos [**, 3.0.0), kubernetes [2.1.4, 3.0.0), list_dag_runs [1.10.2, - 2.0.0), list_dags [**, 2.0.0), list_tasks [**, 2.0.0), next_execution - [1.10.2, 2.0.0), pause [**, 2.0.0), pool [**, 2.0.0), pools [1.10.14, - 3.0.0), render [**, 2.0.0), roles [2.0.0, 3.0.0), run [**, 2.0.0), - sync-perm [1.10.14, 3.0.0), sync_perm [1.10.2, 2.0.0), task_failed_deps - [**, 2.0.0), task_state [**, 2.0.0), tasks [1.10.14, 3.0.0), test [**, - 2.0.0), trigger_dag [**, 2.0.0), unpause [**, 2.0.0), upgrade_check - [1.10.15, 2.0.0), users [1.10.14, 3.0.0), variables [**, 3.0.0), - version [**, 3.0.0) (see + kerberos [**, 3.0.0), kubernetes [2.1.4, 3.0.0), list-import-errors + [**, 3.0.0), list_dag_runs [1.10.2, 2.0.0), list_dags [**, 2.0.0), + list_tasks [**, 2.0.0), next_execution [1.10.2, 2.0.0), pause [**, + 2.0.0), pool [**, 2.0.0), pools [1.10.14, 3.0.0), render [**, 2.0.0), + roles [2.0.0, 3.0.0), run [**, 2.0.0), sync-perm [1.10.14, 3.0.0), + sync_perm [1.10.2, 2.0.0), task_failed_deps [**, 2.0.0), task_state + [**, 2.0.0), tasks [1.10.14, 3.0.0), test [**, 2.0.0), trigger_dag [**, + 2.0.0), unpause [**, 2.0.0), upgrade_check [1.10.15, 2.0.0), users + [1.10.14, 3.0.0), variables [**, 3.0.0), version [**, 3.0.0) (see https://airflow.apache.org/docs/apache-airflow/stable/cli-and-env-variables-ref.html for more info). diff --git a/gcloud/alpha/compute/addresses/describe b/gcloud/alpha/compute/addresses/describe index caef673d1..55a1588f6 100644 --- a/gcloud/alpha/compute/addresses/describe +++ b/gcloud/alpha/compute/addresses/describe @@ -1,6 +1,6 @@ NAME gcloud alpha compute addresses describe - display detailed information - about an address + about a reserved static address SYNOPSIS gcloud alpha compute addresses describe NAME [--global | --region=REGION] @@ -8,7 +8,7 @@ SYNOPSIS DESCRIPTION (ALPHA) gcloud alpha compute addresses describe displays all data - associated with an address in a project. + associated with a reserved static address in a project. EXAMPLES To get details about a global address, run: diff --git a/gcloud/alpha/compute/addresses/help b/gcloud/alpha/compute/addresses/help index 1b9b75d6c..86acb951f 100644 --- a/gcloud/alpha/compute/addresses/help +++ b/gcloud/alpha/compute/addresses/help @@ -35,7 +35,7 @@ COMMANDS (ALPHA) Release reserved IP addresses. describe - (ALPHA) Display detailed information about an address. + (ALPHA) Display detailed information about a reserved static address. list (ALPHA) List addresses. diff --git a/gcloud/alpha/compute/commitments/create b/gcloud/alpha/compute/commitments/create index e08c6b29b..3c8cba10b 100644 --- a/gcloud/alpha/compute/commitments/create +++ b/gcloud/alpha/compute/commitments/create @@ -8,7 +8,8 @@ SYNOPSIS [--merge-source-commitments=MERGE_SOURCE_COMMITMENTS] [--region=REGION] [--split-source-commitment=SPLIT_SOURCE_COMMITMENT] [--type=TYPE; default="general-purpose"] - [--reservations-from-file=RESERVATIONS_FROM_FILE + [--existing-reservation=[name=NAME],[zone=ZONE] + | --reservations-from-file=RESERVATIONS_FROM_FILE | [--reservation=RESERVATION : --reservation-zone=RESERVATION_ZONE --accelerator=[count=COUNT],[type=TYPE] --local-ssd=[interface=INTERFACE],[size=SIZE] @@ -109,6 +110,12 @@ OPTIONAL FLAGS At most one of these can be specified: + --existing-reservation=[name=NAME],[zone=ZONE] + Name and Zone of a reservation to attach to the commitment on + creation. These reservations must be in the same region as the CUD. + example: + --existing-reservation=name=reservation-name,zone=reservation-zone + --reservations-from-file=RESERVATIONS_FROM_FILE Path to a YAML file of multiple reservations' configuration. diff --git a/gcloud/alpha/compute/firewall-rules/migrate b/gcloud/alpha/compute/firewall-rules/migrate index 6e5556709..1abb15e2e 100644 --- a/gcloud/alpha/compute/firewall-rules/migrate +++ b/gcloud/alpha/compute/firewall-rules/migrate @@ -6,7 +6,8 @@ SYNOPSIS gcloud alpha compute firewall-rules migrate --source-network=SOURCE_NETWORK (--bind-tags-to-instances | --export-tag-mapping | --target-firewall-policy=TARGET_FIREWALL_POLICY) - [--tag-mapping-file=TAG_MAPPING_FILE] [GCLOUD_WIDE_FLAG ...] + [--export-terraform-script] [--tag-mapping-file=TAG_MAPPING_FILE] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) gcloud alpha compute firewall-rules migrate is used to create a new @@ -41,6 +42,10 @@ REQUIRED FLAGS result. OPTIONAL FLAGS + --export-terraform-script + If set, migration tool will output a terraform script to create a + Firewall Policy with migrated rules. + --tag-mapping-file=TAG_MAPPING_FILE Path to a JSON file with legacy tags and service accounts to secure tags mapping. diff --git a/gcloud/alpha/compute/instance-templates/create b/gcloud/alpha/compute/instance-templates/create index 0b3fa826c..fb4e862f6 100644 --- a/gcloud/alpha/compute/instance-templates/create +++ b/gcloud/alpha/compute/instance-templates/create @@ -16,6 +16,8 @@ SYNOPSIS [--[no-]enable-nested-virtualization] [--[no-]enable-uefi-networking] [--external-ipv6-address=EXTERNAL_IPV6_ADDRESS] [--external-ipv6-prefix-length=EXTERNAL_IPV6_PREFIX_LENGTH] + [--[no-]graceful-shutdown] + [--graceful-shutdown-max-duration=GRACEFUL_SHUTDOWN_MAX_DURATION] [--host-error-timeout-seconds=HOST_ERROR_TIMEOUT_SECONDS] [--instance-template-region=INSTANCE_TEMPLATE_REGION] [--instance-termination-action=INSTANCE_TERMINATION_ACTION] @@ -394,6 +396,16 @@ FLAGS be used together with --external-ipv6-address. Only the /96 IP address range is supported, and the default value is 96. + --[no-]graceful-shutdown + If set to true, enables graceful shutdown for the instance. Use + --graceful-shutdown to enable and --no-graceful-shutdown to disable. + + --graceful-shutdown-max-duration=GRACEFUL_SHUTDOWN_MAX_DURATION + Specifies time needed to gracefully shutdown the instance. After that + time, the instance goes to STOPPING even if graceful shutdown is not + completed.e.g. 300s, 1h. See $ gcloud topic datetimes for information + on duration formats. + --host-error-timeout-seconds=HOST_ERROR_TIMEOUT_SECONDS The timeout in seconds for host error detection. The value must be set with 30 second increments, with a range of 90 to 330 seconds. If unset, diff --git a/gcloud/alpha/compute/instances/create b/gcloud/alpha/compute/instances/create index 5a1141236..3e657d17a 100644 --- a/gcloud/alpha/compute/instances/create +++ b/gcloud/alpha/compute/instances/create @@ -20,6 +20,8 @@ SYNOPSIS [--[no-]enable-uefi-networking] [--erase-windows-vss-signature] [--external-ipv6-address=EXTERNAL_IPV6_ADDRESS] [--external-ipv6-prefix-length=EXTERNAL_IPV6_PREFIX_LENGTH] + [--[no-]graceful-shutdown] + [--graceful-shutdown-max-duration=GRACEFUL_SHUTDOWN_MAX_DURATION] [--host-error-timeout-seconds=HOST_ERROR_TIMEOUT_SECONDS] [--hostname=HOSTNAME] [--instance-termination-action=INSTANCE_TERMINATION_ACTION] @@ -511,6 +513,16 @@ FLAGS be used together with --external-ipv6-address. Only the /96 IP address range is supported, and the default value is 96. + --[no-]graceful-shutdown + If set to true, enables graceful shutdown for the instance. Use + --graceful-shutdown to enable and --no-graceful-shutdown to disable. + + --graceful-shutdown-max-duration=GRACEFUL_SHUTDOWN_MAX_DURATION + Specifies time needed to gracefully shutdown the instance. After that + time, the instance goes to STOPPING even if graceful shutdown is not + completed.e.g. 300s, 1h. See $ gcloud topic datetimes for information + on duration formats. + --host-error-timeout-seconds=HOST_ERROR_TIMEOUT_SECONDS The timeout in seconds for host error detection. The value must be set with 30 second increments, with a range of 90 to 330 seconds. If unset, diff --git a/gcloud/alpha/compute/instances/set-scheduling b/gcloud/alpha/compute/instances/set-scheduling index 95ef3768b..9fb62eb9f 100644 --- a/gcloud/alpha/compute/instances/set-scheduling +++ b/gcloud/alpha/compute/instances/set-scheduling @@ -4,7 +4,8 @@ NAME SYNOPSIS gcloud alpha compute instances set-scheduling INSTANCE_NAME - [--clear-min-node-cpu] + [--clear-min-node-cpu] [--[no-]graceful-shutdown] + [--graceful-shutdown-max-duration=GRACEFUL_SHUTDOWN_MAX_DURATION] [--host-error-timeout-seconds=HOST_ERROR_TIMEOUT_SECONDS] [--local-ssd-recovery-timeout=LOCAL_SSD_RECOVERY_TIMEOUT] [--min-node-cpu=MIN_NODE_CPU] [--[no-]preemptible] @@ -42,6 +43,16 @@ FLAGS instance min-node-cpu will be cleared. The instance will not be overcommitted and utilize the full CPU count assigned. + --[no-]graceful-shutdown + If set to true, enables graceful shutdown for the instance. Use + --graceful-shutdown to enable and --no-graceful-shutdown to disable. + + --graceful-shutdown-max-duration=GRACEFUL_SHUTDOWN_MAX_DURATION + Specifies time needed to gracefully shutdown the instance. After that + time, the instance goes to STOPPING even if graceful shutdown is not + completed.e.g. 300s, 1h. See $ gcloud topic datetimes for information + on duration formats. + --host-error-timeout-seconds=HOST_ERROR_TIMEOUT_SECONDS The timeout in seconds for host error detection. The value must be set with 30 second increments, with a range of 90 to 330 seconds. If unset, diff --git a/gcloud/alpha/compute/instances/stop b/gcloud/alpha/compute/instances/stop index c72c9bf46..bc8174b71 100644 --- a/gcloud/alpha/compute/instances/stop +++ b/gcloud/alpha/compute/instances/stop @@ -9,10 +9,22 @@ SYNOPSIS DESCRIPTION (ALPHA) gcloud alpha compute instances stop is used to stop a Compute Engine virtual machine. Stopping a VM performs a clean shutdown, much like - invoking the shutdown functionality of a workstation or laptop. Stopping a - VM with a local SSD is not supported and will result in an API error unless - the --discard-local-ssd flag is passed. Stopping a VM which is already - stopped will return without errors. + invoking the shutdown functionality of a workstation or laptop. + + If a VM has any attached Local SSD disks, you must use the + --discard-local-ssd flag to indicate whether or not the Local SSD data + should be discarded. To stop the VM and preserve the Local SSD data when + you stop the VM by setting --discard-local-ssd=False. + + To stop the VM and discard the Local SSD data, specify + --discard-local-ssd=True. + + Preserving the Local SSD disk data incurs costs and is subject to + limitations. See + https://cloud.google.com/compute/docs/disks/local-ssd#stop_instance for + more information. + + Stopping a VM which is already stopped will return without errors. EXAMPLES To stop an instance named test-instance, run: diff --git a/gcloud/alpha/compute/instances/suspend b/gcloud/alpha/compute/instances/suspend index a3d2a75cc..c335fb681 100644 --- a/gcloud/alpha/compute/instances/suspend +++ b/gcloud/alpha/compute/instances/suspend @@ -17,8 +17,17 @@ DESCRIPTION Note: A suspended instance can be resumed by running the gcloud compute instances resume command. - Limitations: See this feature's restrictions at - https://cloud.google.com/compute/docs/instances/suspend-resume-instance#limitations + If a VM has any attached Local SSD disks, you can preserve the Local SSD + data when you suspend the VM by setting --discard-local-ssd=False. + Preserving the Local SSD disk data incurs costs and is subject to + limitations. + + Limitations: + + ▪ Limitations for suspending a VM: + https://cloud.google.com/compute/docs/instances/suspend-resume-instance#limitations + ▪ Limitations for preserving Local SSD data: + https://cloud.google.com/compute/docs/disks/local-ssd#stop_instance EXAMPLES To suspend an instance named test-instance, run: @@ -30,7 +39,7 @@ EXAMPLES $ gcloud alpha compute instances suspend test-instance \ --discard-local-ssd=True - Using '--discard-local-ssd' without a value defaults to True. + Using --discard-local-ssd without a value defaults to True. POSITIONAL ARGUMENTS INSTANCE_NAMES [INSTANCE_NAMES ...] diff --git a/gcloud/alpha/compute/instances/update b/gcloud/alpha/compute/instances/update index e30074d3d..ff113f279 100644 --- a/gcloud/alpha/compute/instances/update +++ b/gcloud/alpha/compute/instances/update @@ -5,6 +5,8 @@ NAME SYNOPSIS gcloud alpha compute instances update INSTANCE_NAME [--[no-]deletion-protection] [--[no-]enable-display-device] + [--[no-]graceful-shutdown] + [--graceful-shutdown-max-duration=GRACEFUL_SHUTDOWN_MAX_DURATION] [--min-cpu-platform=PLATFORM] [--partner-metadata=[KEY=VALUE,...]] [--partner-metadata-from-file=LOCAL_FILE_PATH] [--[no-]shielded-integrity-monitoring] @@ -54,6 +56,16 @@ FLAGS Enable a display device on VM instances. Use --enable-display-device to enable and --no-enable-display-device to disable. + --[no-]graceful-shutdown + If set to true, enables graceful shutdown for the instance. Use + --graceful-shutdown to enable and --no-graceful-shutdown to disable. + + --graceful-shutdown-max-duration=GRACEFUL_SHUTDOWN_MAX_DURATION + Specifies time needed to gracefully shutdown the instance. After that + time, the instance goes to STOPPING even if graceful shutdown is not + completed.e.g. 300s, 1h. See $ gcloud topic datetimes for information + on duration formats. + --min-cpu-platform=PLATFORM When specified, the VM will be scheduled on host with specified CPU architecture or a newer one. To list available CPU platforms in given diff --git a/gcloud/alpha/compute/network-endpoint-groups/create b/gcloud/alpha/compute/network-endpoint-groups/create index 069a8c2da..bf46b75a0 100644 --- a/gcloud/alpha/compute/network-endpoint-groups/create +++ b/gcloud/alpha/compute/network-endpoint-groups/create @@ -4,6 +4,7 @@ NAME SYNOPSIS gcloud alpha compute network-endpoint-groups create NAME + [--client-port-mapping-mode=CLIENT_PORT_MAPPING_MODE] [--default-port=DEFAULT_PORT] [--network=NETWORK] [--network-endpoint-type=NETWORK_ENDPOINT_TYPE; default="gce-vm-ip-port"] [--psc-target-service=PSC_TARGET_SERVICE] @@ -35,6 +36,17 @@ POSITIONAL ARGUMENTS Name of the network endpoint group to operate on. FLAGS + --client-port-mapping-mode=CLIENT_PORT_MAPPING_MODE + Determines the spec of client port maping mode of this group. Port + Mapping is a use case in which NEG specifies routing by mapping client + ports to destinations (e.g. ip and port). + + port-mapping-disabled + Group should not be used for mapping client port to destination. + + client-port-per-endpoint + For each endpoint there is exactly one client port. + --default-port=DEFAULT_PORT The default port to use if the port number is not specified in the network endpoint. @@ -56,8 +68,8 @@ FLAGS network is used if unspecified. This is only supported for NEGs with endpoint type gce-vm-ip-port, - non-gcp-private-ip-port, gce-vm-primary-ip, gce-vm-ip, - private-service-connect, internet-ip-port, or internet-fqdn-port. + non-gcp-private-ip-port, gce-vm-ip, private-service-connect, + internet-ip-port, or internet-fqdn-port. For Private Service Connect NEGs, you can optionally specify --network and --subnet if --psc-target-service points to a published service. If @@ -96,29 +108,25 @@ FLAGS must be specified or every network endpoint in the network endpoint group must have a port specified. - gce-vm-primary-ip - Endpoint IP address must be the primary IP of a VM's primary - network interface in Compute Engine. - serverless The network endpoint is handled by specified serverless infrastructure, such as Cloud Run, App Engine, or Cloud Function. Default port, network, and subnet are not effective for serverless endpoints. + private-service-connect + The network endpoint corresponds to a service outside the VPC, + accessed via Private Service Connect. + gce-vm-ip Endpoint must be the IP address of a VM's network interface in Compute Engine. Instance reference is required. The IP address is optional. If unspecified, the primary NIC address is used. A port must not be specified. - private-service-connect - The network endpoint corresponds to a service outside the VPC, - accessed via Private Service Connect. - NETWORK_ENDPOINT_TYPE must be one of: gce-vm-ip-port, internet-ip-port, internet-fqdn-port, non-gcp-private-ip-port, - gce-vm-primary-ip, serverless, gce-vm-ip, private-service-connect. + serverless, gce-vm-ip, private-service-connect. --psc-target-service=PSC_TARGET_SERVICE PSC target service name to add to the private service connect network @@ -131,9 +139,9 @@ FLAGS region where the network endpoint group is created. This is only supported for NEGs with endpoint type gce-vm-ip-port, - gce-vm-primary-ip, gce-vm-ip, or private-service-connect. For Private - Service Connect NEGs, you can optionally specify --network and --subnet - if --psc-target-service points to a published service. If + gce-vm-ip, or private-service-connect. For Private Service Connect + NEGs, you can optionally specify --network and --subnet if + --psc-target-service points to a published service. If --psc-target-service points to the regional service endpoint of a Google API, do not specify --network or --subnet. diff --git a/gcloud/alpha/compute/network-endpoint-groups/update b/gcloud/alpha/compute/network-endpoint-groups/update index 2de583ef4..7f5997983 100644 --- a/gcloud/alpha/compute/network-endpoint-groups/update +++ b/gcloud/alpha/compute/network-endpoint-groups/update @@ -112,19 +112,6 @@ REQUIRED FLAGS *port* - Required port of the network endpoint to attach unless the NEG default port is set. - gce-vm-primary-ip - - *instance* - Required instance name in same zone as the network - endpoint group. - - The VM instance must belong to the network / subnetwork - associated with the network endpoint group. If the VM instance - is deleted, then any network endpoint group that has a reference - to it is updated. - - *ip* - Required IP address of the network endpoint to attach. The - IP address must be the primary IP of a VM's network interface. - gce-vm-ip *instance* - Required instance name in same zone as the network @@ -187,15 +174,6 @@ REQUIRED FLAGS *port* - Required port of the network endpoint to detach unless NEG default port is set. - gce-vm-primary-ip - - *instance* - Required name of the instance with endpoints to - detach. If the IP address is unset, all endpoints for the - instance in the NEG are detached. - - *ip* - Required IP address of the network endpoint to attach. The - IP address must be the VM network interface's primary IP address. - gce-vm-ip *instance* - Required name of instance with endpoints to diff --git a/gcloud/alpha/compute/routers/create b/gcloud/alpha/compute/routers/create index 06a5c74f6..cf070244d 100644 --- a/gcloud/alpha/compute/routers/create +++ b/gcloud/alpha/compute/routers/create @@ -42,10 +42,11 @@ OPTIONAL FLAGS complete. --bgp-identifier-range=BGP_IDENTIFIER_RANGE - Range of valid BGP Identifiers for this Router. Must be a link-local - IPv4 range from 169.254.0.0/16, of size at least /30, even if the BGP - sessions are over IPv6. It must not overlap with any IPv4 BGP session - ranges. This is commonly called "router ID" by other vendors. + The range of valid BGP Identifiers for this Router. Must be a + link-local IPv4 range from 169.254.0.0/16, of size at least /30, even + if the BGP sessions are over IPv6. It must not overlap with any IPv4 + BGP session ranges. This is commonly called "router ID" by other + vendors. --description=DESCRIPTION An optional description of this router. diff --git a/gcloud/alpha/compute/routers/nats/create b/gcloud/alpha/compute/routers/nats/create index 6327709c7..51104ec0a 100644 --- a/gcloud/alpha/compute/routers/nats/create +++ b/gcloud/alpha/compute/routers/nats/create @@ -225,8 +225,8 @@ OPTIONAL FLAGS Used for private-to-private NAT translations. Allows communication between VPC Networks. PUBLIC - Used for private-to-public NAT translations. Allows VMs to - communicate with the Internet. + Used for private-to-public NAT translations. Allows VM instances to + communicate with the internet. --udp-idle-timeout=UDP_IDLE_TIMEOUT Timeout for UDP connections. See diff --git a/gcloud/alpha/compute/routers/nats/rules/create b/gcloud/alpha/compute/routers/nats/rules/create index 1479f662e..351383b90 100644 --- a/gcloud/alpha/compute/routers/nats/rules/create +++ b/gcloud/alpha/compute/routers/nats/rules/create @@ -78,16 +78,18 @@ OPTIONAL FLAGS CLOUDSDK_COMPUTE_REGION. --source-nat-active-ips=IP_ADDRESS,[IP_ADDRESS,...] - External IP Addresses to use for connections matching this rule. + External IP Addresses to use for connections matching this rule. This + flag is supported only for Public NAT and is required when creating a + Public NAT gateway. - These must be valid reserved external IPs in the same region. + These must be valid reserved external IP addresses in the same region. --source-nat-active-ranges=SUBNETWORK,[SUBNETWORK,...] Subnetworks from which addresses are used for connections matching this - rule. This is only supported for Private NAT, and is required when + rule. This flag is supported only for Private NAT and is required when creating a Private NAT gateway. - These must be Subnetwork resources in the same region, with purpose set + These must be subnetwork resources in the same region, with purpose set to PRIVATE_NAT. GCLOUD WIDE FLAGS diff --git a/gcloud/alpha/compute/routers/nats/rules/update b/gcloud/alpha/compute/routers/nats/rules/update index 0dadf5906..bb2709583 100644 --- a/gcloud/alpha/compute/routers/nats/rules/update +++ b/gcloud/alpha/compute/routers/nats/rules/update @@ -82,22 +82,24 @@ OPTIONAL FLAGS CLOUDSDK_COMPUTE_REGION. --source-nat-active-ips=IP_ADDRESS,[IP_ADDRESS,...] - External IP Addresses to use for connections matching this rule. + External IP Addresses to use for connections matching this rule. This + flag is supported only for Public NAT and is required when creating a + Public NAT gateway. - These must be valid reserved external IPs in the same region. + These must be valid reserved external IP addresses in the same region. --source-nat-active-ranges=SUBNETWORK,[SUBNETWORK,...] Subnetworks from which addresses are used for connections matching this - rule. This is only supported for Private NAT, and is required when + rule. This flag is supported only for Private NAT and is required when creating a Private NAT gateway. - These must be Subnetwork resources in the same region, with purpose set + These must be subnetwork resources in the same region, with purpose set to PRIVATE_NAT. At most one of these can be specified: --clear-source-nat-drain-ips - Clear drained IPs from the Rule + Clear drained IPs from the rule --source-nat-drain-ips=IP_ADDRESS,[IP_ADDRESS,...] External IP Addresses to drain connections on. @@ -108,7 +110,7 @@ OPTIONAL FLAGS At most one of these can be specified: --clear-source-nat-drain-ranges - Clear drained ranges from the Rule + Clear drained ranges from the rule --source-nat-drain-ranges=SUBNETWORK,[SUBNETWORK,...] Subnetwork ranges to drain connections on. diff --git a/gcloud/alpha/compute/routers/update b/gcloud/alpha/compute/routers/update index b82d5683e..ea263f50e 100644 --- a/gcloud/alpha/compute/routers/update +++ b/gcloud/alpha/compute/routers/update @@ -40,10 +40,11 @@ FLAGS complete. --bgp-identifier-range=BGP_IDENTIFIER_RANGE - Range of valid BGP Identifiers for this Router. Must be a link-local - IPv4 range from 169.254.0.0/16, of size at least /30, even if the BGP - sessions are over IPv6. It must not overlap with any IPv4 BGP session - ranges. This is commonly called "router ID" by other vendors. + The range of valid BGP Identifiers for this Router. Must be a + link-local IPv4 range from 169.254.0.0/16, of size at least /30, even + if the BGP sessions are over IPv6. It must not overlap with any IPv4 + BGP session ranges. This is commonly called "router ID" by other + vendors. --keepalive-interval=KEEPALIVE_INTERVAL The interval between BGP keepalive messages that are sent to the peer. diff --git a/gcloud/alpha/compute/target-https-proxies/create b/gcloud/alpha/compute/target-https-proxies/create index 2c265ec25..5249453eb 100644 --- a/gcloud/alpha/compute/target-https-proxies/create +++ b/gcloud/alpha/compute/target-https-proxies/create @@ -118,6 +118,7 @@ OPTIONAL FLAGS To set the location attribute: ◆ provide the argument --server-tls-policy on the command line with a fully specified name; + ◆ provide the argument --region on the command line; ◆ default value of location is [global]. --server-tls-policy=SERVER_TLS_POLICY diff --git a/gcloud/alpha/compute/target-https-proxies/update b/gcloud/alpha/compute/target-https-proxies/update index bd916f6bf..b3449e4a4 100644 --- a/gcloud/alpha/compute/target-https-proxies/update +++ b/gcloud/alpha/compute/target-https-proxies/update @@ -194,6 +194,7 @@ FLAGS To set the location attribute: ▸ provide the argument --server-tls-policy on the command line with a fully specified name; + ▸ provide the argument --region on the command line; ▸ default value of location is [global]. --server-tls-policy=SERVER_TLS_POLICY diff --git a/gcloud/alpha/config/get b/gcloud/alpha/config/get index 23d5c2663..245332eb6 100644 --- a/gcloud/alpha/config/get +++ b/gcloud/alpha/config/get @@ -1059,11 +1059,6 @@ AVAILABLE PROPERTIES resources. When a location value is required but not provided, the command will fall back to this value, if set. - region - Default region to use when working with Cloud NetApp Files regions. - When a --region flag is required but not provided, the command will - fall back to this value, if set. - notebooks location Default location to use when working with Notebook resources. When diff --git a/gcloud/alpha/config/help b/gcloud/alpha/config/help index 69af2a584..393c381a7 100644 --- a/gcloud/alpha/config/help +++ b/gcloud/alpha/config/help @@ -1091,11 +1091,6 @@ AVAILABLE PROPERTIES resources. When a location value is required but not provided, the command will fall back to this value, if set. - region - Default region to use when working with Cloud NetApp Files regions. - When a --region flag is required but not provided, the command will - fall back to this value, if set. - notebooks location Default location to use when working with Notebook resources. When diff --git a/gcloud/alpha/config/list b/gcloud/alpha/config/list index 0398a8e47..ac4ab31b3 100644 --- a/gcloud/alpha/config/list +++ b/gcloud/alpha/config/list @@ -1103,11 +1103,6 @@ AVAILABLE PROPERTIES resources. When a location value is required but not provided, the command will fall back to this value, if set. - region - Default region to use when working with Cloud NetApp Files regions. - When a --region flag is required but not provided, the command will - fall back to this value, if set. - notebooks location Default location to use when working with Notebook resources. When diff --git a/gcloud/alpha/config/set b/gcloud/alpha/config/set index d9a922690..95212f302 100644 --- a/gcloud/alpha/config/set +++ b/gcloud/alpha/config/set @@ -1106,11 +1106,6 @@ AVAILABLE PROPERTIES resources. When a location value is required but not provided, the command will fall back to this value, if set. - region - Default region to use when working with Cloud NetApp Files regions. - When a --region flag is required but not provided, the command will - fall back to this value, if set. - notebooks location Default location to use when working with Notebook resources. When diff --git a/gcloud/alpha/config/unset b/gcloud/alpha/config/unset index 9a8904fd6..011e64685 100644 --- a/gcloud/alpha/config/unset +++ b/gcloud/alpha/config/unset @@ -1067,11 +1067,6 @@ AVAILABLE PROPERTIES resources. When a location value is required but not provided, the command will fall back to this value, if set. - region - Default region to use when working with Cloud NetApp Files regions. - When a --region flag is required but not provided, the command will - fall back to this value, if set. - notebooks location Default location to use when working with Notebook resources. When diff --git a/gcloud/alpha/container/attached/clusters/import b/gcloud/alpha/container/attached/clusters/import index adf08c6af..3701aea9f 100644 --- a/gcloud/alpha/container/attached/clusters/import +++ b/gcloud/alpha/container/attached/clusters/import @@ -9,6 +9,8 @@ SYNOPSIS (--fleet-membership=FLEET_MEMBERSHIP : --fleet-membership-location=FLEET_MEMBERSHIP_LOCATION; default="global") [--async] [--location=LOCATION] [--validate-only] + [--proxy-secret-name=PROXY_SECRET_NAME + --proxy-secret-namespace=PROXY_SECRET_NAMESPACE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -119,6 +121,22 @@ OPTIONAL FLAGS --validate-only Validate the cluster to import, but don't actually perform it. + Proxy config + + --proxy-secret-name=PROXY_SECRET_NAME + Name of the Kubernetes secret that contains the HTTP/HTTPS proxy + configuration. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --proxy-secret-namespace=PROXY_SECRET_NAMESPACE + Namespace of the Kubernetes secret that contains the HTTP/HTTPS proxy + configuration. + + This flag argument must be specified if any of the other arguments in + this group are specified. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/container/clusters/create b/gcloud/alpha/container/clusters/create index 91bf49418..bb65e0634 100644 --- a/gcloud/alpha/container/clusters/create +++ b/gcloud/alpha/container/clusters/create @@ -20,7 +20,6 @@ SYNOPSIS [--cluster-version=CLUSTER_VERSION] [--create-subnetwork=[KEY=VALUE,...]] [--database-encryption-key=DATABASE_ENCRYPTION_KEY] - [--dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE] [--default-max-pods-per-node=DEFAULT_MAX_PODS_PER_NODE] [--disable-default-snat] [--disable-pod-cidr-overprovision] [--disk-size=DISK_SIZE] [--disk-type=DISK_TYPE] [--enable-autorepair] @@ -76,9 +75,12 @@ SYNOPSIS [--additional-zones=ZONE,[ZONE,...] | --node-locations=ZONE,[ZONE,...]] [--cluster-dns=CLUSTER_DNS --cluster-dns-domain=CLUSTER_DNS_DOMAIN --cluster-dns-scope=CLUSTER_DNS_SCOPE] - [--binauthz-policy-bindings=[name=BINAUTHZ_POLICY,...] + [--binauthz-policy-bindings=[name=BINAUTHZ_POLICY] --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE | --enable-binauthz] + [--dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE + | --disable-dataplane-v2-flow-observability + | --enable-dataplane-v2-flow-observability] [--disable-dataplane-v2-metrics | --enable-dataplane-v2-metrics] [[--enable-autoprovisioning : --autoprovisioning-config-file=AUTOPROVISIONING_CONFIG_FILE @@ -357,35 +359,6 @@ FLAGS For more information, see https://cloud.google.com/kubernetes-engine/docs/how-to/encrypting-secrets. - --dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE - Select Advanced Datapath Observability mode for the cluster. Defaults - to DISABLED. - - Advanced Datapath Observability allows for a real-time view into - pod-to-pod traffic within your cluster. - - Examples: - - $ gcloud alpha container clusters create \ - --dataplane-v2-observability-mode=DISABLED - - $ gcloud alpha container clusters create \ - --dataplane-v2-observability-mode=INTERNAL_VPC_LB - - $ gcloud alpha container clusters create \ - --dataplane-v2-observability-mode=EXTERNAL_LB - - DATAPLANE_V2_OBSERVABILITY_MODE must be one of: - - DISABLED - Disables Advanced Datapath Observability. - EXTERNAL_LB - Makes Advanced Datapath Observability available to the external - network. - INTERNAL_VPC_LB - Makes Advanced Datapath Observability available from the VPC - network. - --default-max-pods-per-node=DEFAULT_MAX_PODS_PER_NODE The default max number of pods per node for node pools in the cluster. @@ -1401,7 +1374,7 @@ FLAGS Flags for Binary Authorization: - --binauthz-policy-bindings=[name=BINAUTHZ_POLICY,...] + --binauthz-policy-bindings=[name=BINAUTHZ_POLICY] The relative resource name of the Binary Authorization policy to audit and/or enforce. GKE policies have the following format: projects/{project_number}/platforms/gke/policies/{policy_id}. @@ -1410,9 +1383,9 @@ FLAGS --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE Enable Binary Authorization for this cluster. - BINAUTHZ_EVALUATION_MODE must be one of: DISABLED, POLICY_BINDINGS, - POLICY_BINDINGS_AND_PROJECT_SINGLETON_POLICY_ENFORCE, - PROJECT_SINGLETON_POLICY_ENFORCE. + BINAUTHZ_EVALUATION_MODE must be one of: disabled, policy-bindings, + policy-bindings-and-project-singleton-policy-enforce, + project-singleton-policy-enforce. --enable-binauthz (DEPRECATED) Enable Binary Authorization for this cluster. @@ -1420,6 +1393,44 @@ FLAGS The --enable-binauthz flag is deprecated. Please use --binauthz-evaluation-mode instead. + At most one of these can be specified: + + --dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE + Select Advanced Datapath Observability mode for the cluster. Defaults + to DISABLED. + + Advanced Datapath Observability allows for a real-time view into + pod-to-pod traffic within your cluster. + + Examples: + + $ gcloud alpha container clusters create \ + --dataplane-v2-observability-mode=DISABLED + + $ gcloud alpha container clusters create \ + --dataplane-v2-observability-mode=INTERNAL_VPC_LB + + $ gcloud alpha container clusters create \ + --dataplane-v2-observability-mode=EXTERNAL_LB + + DATAPLANE_V2_OBSERVABILITY_MODE must be one of: + + DISABLED + Disables Advanced Datapath Observability. + EXTERNAL_LB + Makes Advanced Datapath Observability available to the external + network. + INTERNAL_VPC_LB + Makes Advanced Datapath Observability available from the VPC + network. + + --disable-dataplane-v2-flow-observability + Disables Advanced Datapath Observability. + + --enable-dataplane-v2-flow-observability + Enables Advanced Datapath Observability which allows for a real-time + view into pod-to-pod traffic within your cluster. + At most one of these can be specified: --disable-dataplane-v2-metrics diff --git a/gcloud/alpha/container/clusters/create-auto b/gcloud/alpha/container/clusters/create-auto index b61a6965c..a87b6587c 100644 --- a/gcloud/alpha/container/clusters/create-auto +++ b/gcloud/alpha/container/clusters/create-auto @@ -12,7 +12,6 @@ SYNOPSIS [--cluster-version=CLUSTER_VERSION] [--create-subnetwork=[KEY=VALUE,...]] [--database-encryption-key=DATABASE_ENCRYPTION_KEY] - [--dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE] [--enable-backup-restore] [--enable-fleet] [--enable-google-cloud-access] [--enable-kubernetes-unstable-apis=API,[API,...]] @@ -25,7 +24,10 @@ SYNOPSIS [--subnetwork=SUBNETWORK] [--workload-policies=WORKLOAD_POLICIES] [--workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING] [--binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE - --binauthz-policy-bindings=[name=BINAUTHZ_POLICY,...]] + --binauthz-policy-bindings=[name=BINAUTHZ_POLICY]] + [--dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE + | --disable-dataplane-v2-flow-observability + | --enable-dataplane-v2-flow-observability] [--enable-master-authorized-networks --master-authorized-networks=NETWORK,[NETWORK,...]] [--enable-private-endpoint @@ -183,35 +185,6 @@ FLAGS For more information, see https://cloud.google.com/kubernetes-engine/docs/how-to/encrypting-secrets. - --dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE - Select Advanced Datapath Observability mode for the cluster. Defaults - to DISABLED. - - Advanced Datapath Observability allows for a real-time view into - pod-to-pod traffic within your cluster. - - Examples: - - $ gcloud alpha container clusters create-auto \ - --dataplane-v2-observability-mode=DISABLED - - $ gcloud alpha container clusters create-auto \ - --dataplane-v2-observability-mode=INTERNAL_VPC_LB - - $ gcloud alpha container clusters create-auto \ - --dataplane-v2-observability-mode=EXTERNAL_LB - - DATAPLANE_V2_OBSERVABILITY_MODE must be one of: - - DISABLED - Disables Advanced Datapath Observability. - EXTERNAL_LB - Makes Advanced Datapath Observability available to the external - network. - INTERNAL_VPC_LB - Makes Advanced Datapath Observability available from the VPC - network. - --enable-backup-restore Enable the Backup for GKE add-on. This add-on is disabled by default. To learn more, see the Backup for GKE overview: @@ -403,15 +376,53 @@ FLAGS --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE Enable Binary Authorization for this cluster. - BINAUTHZ_EVALUATION_MODE must be one of: DISABLED, POLICY_BINDINGS, - POLICY_BINDINGS_AND_PROJECT_SINGLETON_POLICY_ENFORCE, - PROJECT_SINGLETON_POLICY_ENFORCE. + BINAUTHZ_EVALUATION_MODE must be one of: disabled, policy-bindings, + policy-bindings-and-project-singleton-policy-enforce, + project-singleton-policy-enforce. - --binauthz-policy-bindings=[name=BINAUTHZ_POLICY,...] + --binauthz-policy-bindings=[name=BINAUTHZ_POLICY] The relative resource name of the Binary Authorization policy to audit and/or enforce. GKE policies have the following format: projects/{project_number}/platforms/gke/policies/{policy_id}. + At most one of these can be specified: + + --dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE + Select Advanced Datapath Observability mode for the cluster. Defaults + to DISABLED. + + Advanced Datapath Observability allows for a real-time view into + pod-to-pod traffic within your cluster. + + Examples: + + $ gcloud alpha container clusters create-auto \ + --dataplane-v2-observability-mode=DISABLED + + $ gcloud alpha container clusters create-auto \ + --dataplane-v2-observability-mode=INTERNAL_VPC_LB + + $ gcloud alpha container clusters create-auto \ + --dataplane-v2-observability-mode=EXTERNAL_LB + + DATAPLANE_V2_OBSERVABILITY_MODE must be one of: + + DISABLED + Disables Advanced Datapath Observability. + EXTERNAL_LB + Makes Advanced Datapath Observability available to the external + network. + INTERNAL_VPC_LB + Makes Advanced Datapath Observability available from the VPC + network. + + --disable-dataplane-v2-flow-observability + Disables Advanced Datapath Observability. + + --enable-dataplane-v2-flow-observability + Enables Advanced Datapath Observability which allows for a real-time + view into pod-to-pod traffic within your cluster. + Master Authorized Networks --enable-master-authorized-networks diff --git a/gcloud/alpha/container/clusters/update b/gcloud/alpha/container/clusters/update index 01939202d..460246c99 100644 --- a/gcloud/alpha/container/clusters/update +++ b/gcloud/alpha/container/clusters/update @@ -47,7 +47,7 @@ SYNOPSIS | --additional-zones=[ZONE,...] | --node-locations=ZONE,[ZONE,...] | --cluster-dns=CLUSTER_DNS --cluster-dns-domain=CLUSTER_DNS_DOMAIN --cluster-dns-scope=CLUSTER_DNS_SCOPE - | --binauthz-policy-bindings=[name=BINAUTHZ_POLICY,...] + | --binauthz-policy-bindings=[name=BINAUTHZ_POLICY] --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE | --enable-binauthz | --clear-maintenance-window | --remove-maintenance-exclusion=NAME @@ -63,6 +63,8 @@ SYNOPSIS --enable-resource-consumption-metering --resource-usage-bigquery-dataset=RESOURCE_USAGE_BIGQUERY_DATASET | --dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE + | --disable-dataplane-v2-flow-observability + | --enable-dataplane-v2-flow-observability --disable-dataplane-v2-metrics | --enable-dataplane-v2-metrics | [--enable-autoprovisioning : --autoprovisioning-config-file=AUTOPROVISIONING_CONFIG_FILE @@ -788,7 +790,7 @@ REQUIRED FLAGS Flags for Binary Authorization: - --binauthz-policy-bindings=[name=BINAUTHZ_POLICY,...] + --binauthz-policy-bindings=[name=BINAUTHZ_POLICY] The relative resource name of the Binary Authorization policy to audit and/or enforce. GKE policies have the following format: projects/{project_number}/platforms/gke/policies/{policy_id}. @@ -797,10 +799,10 @@ REQUIRED FLAGS --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE Enable Binary Authorization for this cluster. - BINAUTHZ_EVALUATION_MODE must be one of: DISABLED, - POLICY_BINDINGS, - POLICY_BINDINGS_AND_PROJECT_SINGLETON_POLICY_ENFORCE, - PROJECT_SINGLETON_POLICY_ENFORCE. + BINAUTHZ_EVALUATION_MODE must be one of: disabled, + policy-bindings, + policy-bindings-and-project-singleton-policy-enforce, + project-singleton-policy-enforce. --enable-binauthz (DEPRECATED) Enable Binary Authorization for this cluster. @@ -944,34 +946,43 @@ REQUIRED FLAGS $ gcloud alpha container clusters update example-cluster \ --resource-usage-bigquery-dataset=example_bigquery_dataset_name - --dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE - Select Advanced Datapath Observability mode for the cluster. Defaults - to DISABLED. + At most one of these can be specified: - Advanced Datapath Observability allows for a real-time view into - pod-to-pod traffic within your cluster. + --dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE + Select Advanced Datapath Observability mode for the cluster. + Defaults to DISABLED. - Examples: + Advanced Datapath Observability allows for a real-time view into + pod-to-pod traffic within your cluster. - $ gcloud alpha container clusters update \ - --dataplane-v2-observability-mode=DISABLED + Examples: - $ gcloud alpha container clusters update \ - --dataplane-v2-observability-mode=INTERNAL_VPC_LB + $ gcloud alpha container clusters update \ + --dataplane-v2-observability-mode=DISABLED - $ gcloud alpha container clusters update \ - --dataplane-v2-observability-mode=EXTERNAL_LB + $ gcloud alpha container clusters update \ + --dataplane-v2-observability-mode=INTERNAL_VPC_LB - DATAPLANE_V2_OBSERVABILITY_MODE must be one of: + $ gcloud alpha container clusters update \ + --dataplane-v2-observability-mode=EXTERNAL_LB - DISABLED - Disables Advanced Datapath Observability. - EXTERNAL_LB - Makes Advanced Datapath Observability available to the external - network. - INTERNAL_VPC_LB - Makes Advanced Datapath Observability available from the VPC - network. + DATAPLANE_V2_OBSERVABILITY_MODE must be one of: + + DISABLED + Disables Advanced Datapath Observability. + EXTERNAL_LB + Makes Advanced Datapath Observability available to the external + network. + INTERNAL_VPC_LB + Makes Advanced Datapath Observability available from the VPC + network. + + --disable-dataplane-v2-flow-observability + Disables Advanced Datapath Observability. + + --enable-dataplane-v2-flow-observability + Enables Advanced Datapath Observability which allows for a + real-time view into pod-to-pod traffic within your cluster. At most one of these can be specified: diff --git a/gcloud/alpha/container/fleet/create b/gcloud/alpha/container/fleet/create index 5da50288f..bf5bb8d40 100644 --- a/gcloud/alpha/container/fleet/create +++ b/gcloud/alpha/container/fleet/create @@ -4,7 +4,9 @@ NAME SYNOPSIS gcloud alpha container fleet create [--async] [--display-name=DISPLAY_NAME] [--labels=[KEY=VALUE,...]] - [--security-posture=SECURITY_POSTURE + [--binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE + --binauthz-policy-bindings=[name=BINAUTHZ_POLICY,...] + --security-posture=SECURITY_POSTURE --workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING] [GCLOUD_WIDE_FLAG ...] @@ -41,6 +43,22 @@ FLAGS Default cluster configurations to apply across the fleet. + Binary Authorization config. + + --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE + Configure binary authorization mode for clusters to onboard the + fleet, + + $ gcloud alpha container fleet create \ + --binauthz-evaluation-mode=POLICY_BINDINGS + + BINAUTHZ_EVALUATION_MODE must be one of: DISABLED, POLICY_BINDINGS. + + --binauthz-policy-bindings=[name=BINAUTHZ_POLICY,...] + The relative resource name of the Binary Authorization policy to + audit and/or enforce. GKE policies have the following format: + projects/{project_number}/platforms/gke/policies/{policy_id}. + Security posture config. --security-posture=SECURITY_POSTURE diff --git a/gcloud/alpha/container/fleet/dataplane-v2-encryption/describe b/gcloud/alpha/container/fleet/dataplane-v2-encryption/describe new file mode 100644 index 000000000..110f1cd40 --- /dev/null +++ b/gcloud/alpha/container/fleet/dataplane-v2-encryption/describe @@ -0,0 +1,35 @@ +NAME + gcloud alpha container fleet dataplane-v2-encryption describe - describes + the status of the Dataplane V2 Encryption Feature resource + +SYNOPSIS + gcloud alpha container fleet dataplane-v2-encryption describe + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) This command gets the detailed status of the Dataplane V2 + Encryption Feature in a fleet. + +EXAMPLES + To describe the Dataplane V2 Encryption Feature, run: + + $ gcloud alpha container fleet dataplane-v2-encryption describe + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --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 container fleet dataplane-v2-encryption describe + + $ gcloud beta container fleet dataplane-v2-encryption describe + diff --git a/gcloud/alpha/container/fleet/dataplane-v2-encryption/disable b/gcloud/alpha/container/fleet/dataplane-v2-encryption/disable new file mode 100644 index 000000000..041950da2 --- /dev/null +++ b/gcloud/alpha/container/fleet/dataplane-v2-encryption/disable @@ -0,0 +1,40 @@ +NAME + gcloud alpha container fleet dataplane-v2-encryption disable - disables the + Dataplane V2 Encryption Feature + +SYNOPSIS + gcloud alpha container fleet dataplane-v2-encryption disable [--force] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) This command disables the Dataplane V2 Encryption Feature in a + fleet. + +EXAMPLES + To disable the Dataplane V2 Encryption Feature, run: + + $ gcloud alpha container fleet dataplane-v2-encryption disable + +FLAGS + --force + Disable this feature, even if it is currently in use. Force disablement + may result in unexpected behavior. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --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 container fleet dataplane-v2-encryption disable + + $ gcloud beta container fleet dataplane-v2-encryption disable + diff --git a/gcloud/alpha/container/fleet/dataplane-v2-encryption/enable b/gcloud/alpha/container/fleet/dataplane-v2-encryption/enable new file mode 100644 index 000000000..4e12bacbf --- /dev/null +++ b/gcloud/alpha/container/fleet/dataplane-v2-encryption/enable @@ -0,0 +1,35 @@ +NAME + gcloud alpha container fleet dataplane-v2-encryption enable - enables the + Dataplane V2 Encryption Feature + +SYNOPSIS + gcloud alpha container fleet dataplane-v2-encryption enable + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) This command enables the Dataplane V2 Encryption Feature in a + fleet. + +EXAMPLES + To enable the Dataplane V2 Encryption Feature, run: + + $ gcloud alpha container fleet dataplane-v2-encryption enable + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --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 container fleet dataplane-v2-encryption enable + + $ gcloud beta container fleet dataplane-v2-encryption enable + diff --git a/gcloud/alpha/container/fleet/dataplane-v2-encryption/help b/gcloud/alpha/container/fleet/dataplane-v2-encryption/help new file mode 100644 index 000000000..0276aec0f --- /dev/null +++ b/gcloud/alpha/container/fleet/dataplane-v2-encryption/help @@ -0,0 +1,39 @@ +NAME + gcloud alpha container fleet dataplane-v2-encryption - manage Dataplane V2 + Encryption Feature + +SYNOPSIS + gcloud alpha container fleet dataplane-v2-encryption COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Dataplane V2 Encryption Feature. + +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) Describes the status of the Dataplane V2 Encryption Feature + resource. + + disable + (ALPHA) Disables the Dataplane V2 Encryption Feature. + + enable + (ALPHA) Enables the Dataplane V2 Encryption Feature. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. These variants are also available: + + $ gcloud container fleet dataplane-v2-encryption + + $ gcloud beta container fleet dataplane-v2-encryption + diff --git a/gcloud/alpha/container/fleet/help b/gcloud/alpha/container/fleet/help index 650d0b402..560ee9e97 100644 --- a/gcloud/alpha/container/fleet/help +++ b/gcloud/alpha/container/fleet/help @@ -54,6 +54,9 @@ GROUPS config-management (ALPHA) Manage Config Management Feature. + dataplane-v2-encryption + (ALPHA) Manage Dataplane V2 Encryption Feature. + features (ALPHA) Manage Hub Feature resources. diff --git a/gcloud/alpha/container/fleet/memberships/delete b/gcloud/alpha/container/fleet/memberships/delete index b84a420ec..0b7885b99 100644 --- a/gcloud/alpha/container/fleet/memberships/delete +++ b/gcloud/alpha/container/fleet/memberships/delete @@ -73,7 +73,7 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the gkehub/v1alpha2 API. The full documentation for this + This command uses the gkehub/v1alpha API. The full documentation for this API can be found at: https://cloud.google.com/anthos/multicluster-management/connect/registering-a-cluster diff --git a/gcloud/alpha/container/fleet/memberships/describe b/gcloud/alpha/container/fleet/memberships/describe index 31cfc6d94..edcaf88ac 100644 --- a/gcloud/alpha/container/fleet/memberships/describe +++ b/gcloud/alpha/container/fleet/memberships/describe @@ -61,7 +61,7 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the gkehub/v1alpha2 API. The full documentation for this + This command uses the gkehub/v1alpha API. The full documentation for this API can be found at: https://cloud.google.com/anthos/multicluster-management/connect/registering-a-cluster diff --git a/gcloud/alpha/container/fleet/memberships/list b/gcloud/alpha/container/fleet/memberships/list index dd3341d18..d870b33e4 100644 --- a/gcloud/alpha/container/fleet/memberships/list +++ b/gcloud/alpha/container/fleet/memberships/list @@ -55,7 +55,7 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the gkehub/v1alpha2 API. The full documentation for this + This command uses the gkehub/v1alpha API. The full documentation for this API can be found at: https://cloud.google.com/anthos/multicluster-management/connect/registering-a-cluster diff --git a/gcloud/alpha/container/fleet/memberships/update b/gcloud/alpha/container/fleet/memberships/update index 869403c87..9b90ddcd6 100644 --- a/gcloud/alpha/container/fleet/memberships/update +++ b/gcloud/alpha/container/fleet/memberships/update @@ -97,7 +97,7 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the gkehub/v1alpha2 API. The full documentation for this + This command uses the gkehub/v1alpha API. The full documentation for this API can be found at: https://cloud.google.com/anthos/multicluster-management/connect/registering-a-cluster diff --git a/gcloud/alpha/container/fleet/policycontroller/deployment/remove b/gcloud/alpha/container/fleet/policycontroller/deployment/remove index f918f671b..ecc5bb0eb 100644 --- a/gcloud/alpha/container/fleet/policycontroller/deployment/remove +++ b/gcloud/alpha/container/fleet/policycontroller/deployment/remove @@ -64,6 +64,11 @@ EXAMPLES $ gcloud alpha container fleet policycontroller deployment remove \ audit cpu-request + To remove the anti-affinity configuration: + + $ gcloud alpha container fleet policycontroller deployment remove \ + admission pod-affinity + POSITIONAL ARGUMENTS DEPLOYMENT The PolicyController deployment component (i.e, "admission", "audit" or diff --git a/gcloud/alpha/container/fleet/policycontroller/deployment/set b/gcloud/alpha/container/fleet/policycontroller/deployment/set index 126f65546..ae8463065 100644 --- a/gcloud/alpha/container/fleet/policycontroller/deployment/set +++ b/gcloud/alpha/container/fleet/policycontroller/deployment/set @@ -72,6 +72,12 @@ EXAMPLES $ gcloud alpha container fleet policycontroller deployment set \ audit cpu-request 250m + To set anti-affinity to achieve high availability on the mutation + deployment: + + $ gcloud alpha container fleet policycontroller deployment set \ + mutation pod-affinity anti + POSITIONAL ARGUMENTS DEPLOYMENT The PolicyController deployment component (e.g. "admission", "audit" or diff --git a/gcloud/alpha/container/fleet/update b/gcloud/alpha/container/fleet/update index 1061086db..a87a413ed 100644 --- a/gcloud/alpha/container/fleet/update +++ b/gcloud/alpha/container/fleet/update @@ -4,7 +4,9 @@ NAME SYNOPSIS gcloud alpha container fleet update [--async] [--display-name=DISPLAY_NAME] [--update-labels=[KEY=VALUE,...]] - [--security-posture=SECURITY_POSTURE + [--binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE + --binauthz-policy-bindings=[name=BINAUTHZ_POLICY,...] + --security-posture=SECURITY_POSTURE --workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] @@ -42,6 +44,22 @@ FLAGS Default cluster configurations to apply across the fleet. + Binary Authorization config. + + --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE + Configure binary authorization mode for clusters to onboard the + fleet, + + $ gcloud alpha container fleet update \ + --binauthz-evaluation-mode=POLICY_BINDINGS + + BINAUTHZ_EVALUATION_MODE must be one of: DISABLED, POLICY_BINDINGS. + + --binauthz-policy-bindings=[name=BINAUTHZ_POLICY,...] + The relative resource name of the Binary Authorization policy to + audit and/or enforce. GKE policies have the following format: + projects/{project_number}/platforms/gke/policies/{policy_id}. + Security posture config. --security-posture=SECURITY_POSTURE diff --git a/gcloud/alpha/container/hub/create b/gcloud/alpha/container/hub/create index 219766a99..9d93496b1 100644 --- a/gcloud/alpha/container/hub/create +++ b/gcloud/alpha/container/hub/create @@ -4,7 +4,9 @@ NAME SYNOPSIS gcloud alpha container hub create [--async] [--display-name=DISPLAY_NAME] [--labels=[KEY=VALUE,...]] - [--security-posture=SECURITY_POSTURE + [--binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE + --binauthz-policy-bindings=[name=BINAUTHZ_POLICY,...] + --security-posture=SECURITY_POSTURE --workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING] [GCLOUD_WIDE_FLAG ...] @@ -41,6 +43,22 @@ FLAGS Default cluster configurations to apply across the fleet. + Binary Authorization config. + + --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE + Configure binary authorization mode for clusters to onboard the + fleet, + + $ gcloud alpha container hub create \ + --binauthz-evaluation-mode=POLICY_BINDINGS + + BINAUTHZ_EVALUATION_MODE must be one of: DISABLED, POLICY_BINDINGS. + + --binauthz-policy-bindings=[name=BINAUTHZ_POLICY,...] + The relative resource name of the Binary Authorization policy to + audit and/or enforce. GKE policies have the following format: + projects/{project_number}/platforms/gke/policies/{policy_id}. + Security posture config. --security-posture=SECURITY_POSTURE diff --git a/gcloud/alpha/container/hub/dataplane-v2-encryption/describe b/gcloud/alpha/container/hub/dataplane-v2-encryption/describe new file mode 100644 index 000000000..f9ea191fa --- /dev/null +++ b/gcloud/alpha/container/hub/dataplane-v2-encryption/describe @@ -0,0 +1,35 @@ +NAME + gcloud alpha container hub dataplane-v2-encryption describe - describes the + status of the Dataplane V2 Encryption Feature resource + +SYNOPSIS + gcloud alpha container hub dataplane-v2-encryption describe + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) This command gets the detailed status of the Dataplane V2 + Encryption Feature in a fleet. + +EXAMPLES + To describe the Dataplane V2 Encryption Feature, run: + + $ gcloud alpha container hub dataplane-v2-encryption describe + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --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 container hub dataplane-v2-encryption describe + + $ gcloud beta container hub dataplane-v2-encryption describe + diff --git a/gcloud/alpha/container/hub/dataplane-v2-encryption/disable b/gcloud/alpha/container/hub/dataplane-v2-encryption/disable new file mode 100644 index 000000000..862aeaef7 --- /dev/null +++ b/gcloud/alpha/container/hub/dataplane-v2-encryption/disable @@ -0,0 +1,40 @@ +NAME + gcloud alpha container hub dataplane-v2-encryption disable - disables the + Dataplane V2 Encryption Feature + +SYNOPSIS + gcloud alpha container hub dataplane-v2-encryption disable [--force] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) This command disables the Dataplane V2 Encryption Feature in a + fleet. + +EXAMPLES + To disable the Dataplane V2 Encryption Feature, run: + + $ gcloud alpha container hub dataplane-v2-encryption disable + +FLAGS + --force + Disable this feature, even if it is currently in use. Force disablement + may result in unexpected behavior. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --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 container hub dataplane-v2-encryption disable + + $ gcloud beta container hub dataplane-v2-encryption disable + diff --git a/gcloud/alpha/container/hub/dataplane-v2-encryption/enable b/gcloud/alpha/container/hub/dataplane-v2-encryption/enable new file mode 100644 index 000000000..bacc23906 --- /dev/null +++ b/gcloud/alpha/container/hub/dataplane-v2-encryption/enable @@ -0,0 +1,35 @@ +NAME + gcloud alpha container hub dataplane-v2-encryption enable - enables the + Dataplane V2 Encryption Feature + +SYNOPSIS + gcloud alpha container hub dataplane-v2-encryption enable + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) This command enables the Dataplane V2 Encryption Feature in a + fleet. + +EXAMPLES + To enable the Dataplane V2 Encryption Feature, run: + + $ gcloud alpha container hub dataplane-v2-encryption enable + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --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 container hub dataplane-v2-encryption enable + + $ gcloud beta container hub dataplane-v2-encryption enable + diff --git a/gcloud/alpha/container/hub/dataplane-v2-encryption/help b/gcloud/alpha/container/hub/dataplane-v2-encryption/help new file mode 100644 index 000000000..79e2f7d36 --- /dev/null +++ b/gcloud/alpha/container/hub/dataplane-v2-encryption/help @@ -0,0 +1,39 @@ +NAME + gcloud alpha container hub dataplane-v2-encryption - manage Dataplane V2 + Encryption Feature + +SYNOPSIS + gcloud alpha container hub dataplane-v2-encryption COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Dataplane V2 Encryption Feature. + +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) Describes the status of the Dataplane V2 Encryption Feature + resource. + + disable + (ALPHA) Disables the Dataplane V2 Encryption Feature. + + enable + (ALPHA) Enables the Dataplane V2 Encryption Feature. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. These variants are also available: + + $ gcloud container hub dataplane-v2-encryption + + $ gcloud beta container hub dataplane-v2-encryption + diff --git a/gcloud/alpha/container/hub/help b/gcloud/alpha/container/hub/help index 3ae29b0fa..2eced656f 100644 --- a/gcloud/alpha/container/hub/help +++ b/gcloud/alpha/container/hub/help @@ -54,6 +54,9 @@ GROUPS config-management (ALPHA) Manage Config Management Feature. + dataplane-v2-encryption + (ALPHA) Manage Dataplane V2 Encryption Feature. + features (ALPHA) Manage Hub Feature resources. diff --git a/gcloud/alpha/container/hub/memberships/delete b/gcloud/alpha/container/hub/memberships/delete index ec31d3452..73d6856c4 100644 --- a/gcloud/alpha/container/hub/memberships/delete +++ b/gcloud/alpha/container/hub/memberships/delete @@ -73,7 +73,7 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the gkehub/v1alpha2 API. The full documentation for this + This command uses the gkehub/v1alpha API. The full documentation for this API can be found at: https://cloud.google.com/anthos/multicluster-management/connect/registering-a-cluster diff --git a/gcloud/alpha/container/hub/memberships/describe b/gcloud/alpha/container/hub/memberships/describe index 3f3543f33..98460194f 100644 --- a/gcloud/alpha/container/hub/memberships/describe +++ b/gcloud/alpha/container/hub/memberships/describe @@ -61,7 +61,7 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the gkehub/v1alpha2 API. The full documentation for this + This command uses the gkehub/v1alpha API. The full documentation for this API can be found at: https://cloud.google.com/anthos/multicluster-management/connect/registering-a-cluster diff --git a/gcloud/alpha/container/hub/memberships/list b/gcloud/alpha/container/hub/memberships/list index cfb0009c7..f69c4fe76 100644 --- a/gcloud/alpha/container/hub/memberships/list +++ b/gcloud/alpha/container/hub/memberships/list @@ -55,7 +55,7 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the gkehub/v1alpha2 API. The full documentation for this + This command uses the gkehub/v1alpha API. The full documentation for this API can be found at: https://cloud.google.com/anthos/multicluster-management/connect/registering-a-cluster diff --git a/gcloud/alpha/container/hub/memberships/update b/gcloud/alpha/container/hub/memberships/update index 5ed8ffcff..554866b1f 100644 --- a/gcloud/alpha/container/hub/memberships/update +++ b/gcloud/alpha/container/hub/memberships/update @@ -97,7 +97,7 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the gkehub/v1alpha2 API. The full documentation for this + This command uses the gkehub/v1alpha API. The full documentation for this API can be found at: https://cloud.google.com/anthos/multicluster-management/connect/registering-a-cluster diff --git a/gcloud/alpha/container/hub/policycontroller/deployment/remove b/gcloud/alpha/container/hub/policycontroller/deployment/remove index 42ec94162..35899c926 100644 --- a/gcloud/alpha/container/hub/policycontroller/deployment/remove +++ b/gcloud/alpha/container/hub/policycontroller/deployment/remove @@ -64,6 +64,11 @@ EXAMPLES $ gcloud alpha container hub policycontroller deployment remove \ audit cpu-request + To remove the anti-affinity configuration: + + $ gcloud alpha container hub policycontroller deployment remove \ + admission pod-affinity + POSITIONAL ARGUMENTS DEPLOYMENT The PolicyController deployment component (i.e, "admission", "audit" or diff --git a/gcloud/alpha/container/hub/policycontroller/deployment/set b/gcloud/alpha/container/hub/policycontroller/deployment/set index 098aa600c..572b95c3a 100644 --- a/gcloud/alpha/container/hub/policycontroller/deployment/set +++ b/gcloud/alpha/container/hub/policycontroller/deployment/set @@ -72,6 +72,12 @@ EXAMPLES $ gcloud alpha container hub policycontroller deployment set audit \ cpu-request 250m + To set anti-affinity to achieve high availability on the mutation + deployment: + + $ gcloud alpha container hub policycontroller deployment set \ + mutation pod-affinity anti + POSITIONAL ARGUMENTS DEPLOYMENT The PolicyController deployment component (e.g. "admission", "audit" or diff --git a/gcloud/alpha/container/hub/update b/gcloud/alpha/container/hub/update index 7a5fbebb9..8c4cccf1d 100644 --- a/gcloud/alpha/container/hub/update +++ b/gcloud/alpha/container/hub/update @@ -4,7 +4,9 @@ NAME SYNOPSIS gcloud alpha container hub update [--async] [--display-name=DISPLAY_NAME] [--update-labels=[KEY=VALUE,...]] - [--security-posture=SECURITY_POSTURE + [--binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE + --binauthz-policy-bindings=[name=BINAUTHZ_POLICY,...] + --security-posture=SECURITY_POSTURE --workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] @@ -42,6 +44,22 @@ FLAGS Default cluster configurations to apply across the fleet. + Binary Authorization config. + + --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE + Configure binary authorization mode for clusters to onboard the + fleet, + + $ gcloud alpha container hub update \ + --binauthz-evaluation-mode=POLICY_BINDINGS + + BINAUTHZ_EVALUATION_MODE must be one of: DISABLED, POLICY_BINDINGS. + + --binauthz-policy-bindings=[name=BINAUTHZ_POLICY,...] + The relative resource name of the Binary Authorization policy to + audit and/or enforce. GKE policies have the following format: + projects/{project_number}/platforms/gke/policies/{policy_id}. + Security posture config. --security-posture=SECURITY_POSTURE diff --git a/gcloud/alpha/container/node-pools/create b/gcloud/alpha/container/node-pools/create index 7ff6c8fb0..0edfd76d8 100644 --- a/gcloud/alpha/container/node-pools/create +++ b/gcloud/alpha/container/node-pools/create @@ -21,8 +21,9 @@ SYNOPSIS [--enable-blue-green-upgrade] [--enable-confidential-nodes] [--enable-confidential-storage] [--enable-gvnic] [--enable-image-streaming] [--enable-private-nodes] - [--enable-surge-upgrade] [--image-type=IMAGE_TYPE] - [--labels=[KEY=VALUE,...]] [--linux-sysctls=KEY=VALUE,[KEY=VALUE,...]] + [--enable-queued-provisioning] [--enable-surge-upgrade] + [--image-type=IMAGE_TYPE] [--labels=[KEY=VALUE,...]] + [--linux-sysctls=KEY=VALUE,[KEY=VALUE,...]] [--logging-variant=LOGGING_VARIANT] [--machine-type=MACHINE_TYPE, -m MACHINE_TYPE] [--max-pods-per-node=MAX_PODS_PER_NODE] @@ -255,6 +256,14 @@ FLAGS addresses only, regardless of whether private nodes are enabled or disabled. + --enable-queued-provisioning + Mark the newly created nodepool as Queued only. This means that all new + nodes can be obtained only through queuing via Cluster Autoscaler + ProvisioningRequest API. + + $ gcloud alpha container node-pools create node-pool-1 \ + --cluster=example-cluster --enable-queued-provisioning + --enable-surge-upgrade Changes node pool upgrade strategy to surge upgrade. diff --git a/gcloud/alpha/domains/registrations/configure/management b/gcloud/alpha/domains/registrations/configure/management index c15eb179d..5105bc7be 100644 --- a/gcloud/alpha/domains/registrations/configure/management +++ b/gcloud/alpha/domains/registrations/configure/management @@ -4,19 +4,29 @@ NAME SYNOPSIS gcloud alpha domains registrations configure management REGISTRATION - [--async] [--transfer-lock-state=TRANSFER_LOCK_STATE] - [GCLOUD_WIDE_FLAG ...] + [--async] [--preferred-renewal-method=PREFERRED_RENEWAL_METHOD] + [--transfer-lock-state=TRANSFER_LOCK_STATE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Configure management settings of a registration. This includes settings related to transfers, billing and renewals of a registration. EXAMPLES + To start an interactive flow to configure management settings for + example.com, run: + + $ gcloud alpha domains registrations configure management example.com + To unlock a transfer lock of a registration for example.com, run: $ gcloud alpha domains registrations configure management \ example.com --transfer-lock-state=unlocked + To disable automatic renewals for example.com, run: + + $ gcloud alpha domains registrations configure management \ + example.com --preferred-renewal-method=renewal-disabled + POSITIONAL ARGUMENTS Registration resource - The domain registration to configure management settings for. This represents a Cloud resource. (NOTE) Some attributes are @@ -47,6 +57,17 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --preferred-renewal-method=PREFERRED_RENEWAL_METHOD + Preferred Renewal Method of a registration. It defines how the + registration should be renewed. The actual Renewal Method can be set to + renewal-disabled in case of e.g. problems with the Billing Account or + reporeted domain abuse. PREFERRED_RENEWAL_METHOD must be one of: + + automatic-renewal + The domain is automatically renewed each year. + renewal-disabled + The domain won't be renewed and will expire at its expiration time. + --transfer-lock-state=TRANSFER_LOCK_STATE Transfer Lock of a registration. It needs to be unlocked in order to transfer the domain to another registrar. TRANSFER_LOCK_STATE must be diff --git a/gcloud/alpha/filestore/instances/create b/gcloud/alpha/filestore/instances/create index 2398b688d..a3f022c57 100644 --- a/gcloud/alpha/filestore/instances/create +++ b/gcloud/alpha/filestore/instances/create @@ -239,8 +239,7 @@ OPTIONAL FLAGS basic-ssd Performant NFS storage system using SSD. enterprise - Enterprise instances offer the features and availability needed for - mission-critical workloads. + Enterprise instance. Use REGIONAL instead whenever possible. high-scale-ssd High Scale SSD instance, an alias for ZONAL. Use ZONAL instead whenever possible. diff --git a/gcloud/alpha/firestore/databases/restore b/gcloud/alpha/firestore/databases/restore index 8e796c081..7b1cea405 100644 --- a/gcloud/alpha/firestore/databases/restore +++ b/gcloud/alpha/firestore/databases/restore @@ -14,11 +14,25 @@ EXAMPLES --source-backup=projects/PROJECT_ID/locations/LOCATION_ID/\ backups/BACKUP_ID --destination-database=DATABASE_ID + To restore a database from a database snapshot. + + $ gcloud alpha firestore databases restore \ + --source-database=SOURCE_DB \ + --snapshot-time=2023-05-26T10:20:00.00Z \ + --destination-database=DATABASE_ID + REQUIRED FLAGS --destination-database=DESTINATION_DATABASE Destination database to restore to. Destination database will be created in the same location as the source backup. + This value should be 4-63 characters. Valid characters are + /[a-z][0-9]-/ with first character a letter and the last a letter or a + number. Must not be UUID-like + /[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}/. + + Using "(default)" database ID is also allowed. + For example, to restore to database testdb: $ gcloud alpha firestore databases restore \ diff --git a/gcloud/alpha/firestore/indexes/composite/create b/gcloud/alpha/firestore/indexes/composite/create index e9ca006b4..372bb2e11 100644 --- a/gcloud/alpha/firestore/indexes/composite/create +++ b/gcloud/alpha/firestore/indexes/composite/create @@ -31,31 +31,32 @@ EXAMPLES REQUIRED FLAGS --field-config=[array-config=ARRAY-CONFIG],[field-path=FIELD-PATH],[order=ORDER] - Configuration for a field. - - This flag must be repeated to provide the ordered list of field - configurations comprising the composite index. For example: - - $ gcloud alpha firestore indexes composite create \ - --collection-group=Events \ - --field-config field-path=tags,array-config=contains \ - --field-config field-path=user_id,order=descending \ - --field-config field-path=timestamp,order=descending - - The following keys are allowed: - - field-path - Specifies the field path (e.g. 'address.city'). This is required. - - order - Specifies the order. Valid options are: 'ascending', 'descending'. - Exactly one of order or array-config must be specified. + Configuration for a field. Required, Configuration for a field. array-config Specifies the configuration for an array field. The only valid option is 'contains'. Exactly one of 'order' or 'array-config' must be specified. + field-path + Specifies the field path (e.g. 'address.city'). This is required. + + order + Specifies the order. Valid options are 'ascending', 'descending'. + Exactly one of order or array-config must be specified. + + Shorthand Example: + + --field-config=array-config=string,field-path=string,order=string --field-config=array-config=string,field-path=string,order=string + + JSON Example: + + --field-config='[{"array-config": "string", "field-path": "string", "order": "string"}]' + + File Example: + + --field-config=path_to_file.(yaml|json) + Collection group resource - Collection group of the index. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some attributes are not given arguments in this group but can be diff --git a/gcloud/alpha/healthcare/datasets/create b/gcloud/alpha/healthcare/datasets/create index b6f463e88..7d80ef001 100644 --- a/gcloud/alpha/healthcare/datasets/create +++ b/gcloud/alpha/healthcare/datasets/create @@ -4,7 +4,8 @@ NAME SYNOPSIS gcloud alpha healthcare datasets create (DATASET : --location=LOCATION) - [--async] [--time-zone=TIME_ZONE] [GCLOUD_WIDE_FLAG ...] + [--async] [--encryption-key=ENCRYPTION_KEY] [--time-zone=TIME_ZONE] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Create a new Cloud Healthcare API dataset @@ -56,6 +57,15 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --encryption-key=ENCRYPTION_KEY + KMS encryption key that is used to secure this dataset and its + sub-resources. The key used for encryption and the dataset must be in + the same location. If empty, the default Google encryption key will be + used to secure this dataset. The format is + projects/{projectId}/locations/{locationId}/keyRings/{keyRingId}/cryptoKeys/{keyId}. + + Note: This feature is available upon request. + --time-zone=TIME_ZONE Default timezone used by this dataset. diff --git a/gcloud/alpha/healthcare/hl7v2-stores/help b/gcloud/alpha/healthcare/hl7v2-stores/help index dda7ff293..7a8a149ca 100644 --- a/gcloud/alpha/healthcare/hl7v2-stores/help +++ b/gcloud/alpha/healthcare/hl7v2-stores/help @@ -44,6 +44,9 @@ COMMANDS list (ALPHA) List Cloud Healthcare API HL7v2 stores. + metrics + (ALPHA) Gets the metrics for a Cloud Healthcare API HL7v2 store. + remove-iam-policy-binding (ALPHA) Remove an IAM policy binding from a Cloud Healthcare API HL7v2 store. diff --git a/gcloud/alpha/healthcare/hl7v2-stores/metrics b/gcloud/alpha/healthcare/hl7v2-stores/metrics new file mode 100644 index 000000000..fd6eb0e82 --- /dev/null +++ b/gcloud/alpha/healthcare/hl7v2-stores/metrics @@ -0,0 +1,81 @@ +NAME + gcloud alpha healthcare hl7v2-stores metrics - gets the metrics for a Cloud + Healthcare API HL7v2 store + +SYNOPSIS + gcloud alpha healthcare hl7v2-stores metrics + (HL7V2_STORE : --dataset=DATASET --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Gets the metrics for a Cloud Healthcare API HL7v2 store. + +EXAMPLES + To get metrics for the HL7v2 store 'test-hl7v2-store', run: + + $ gcloud alpha healthcare hl7v2-stores metrics test-hl7v2-store \ + --dataset=test-dataset + +POSITIONAL ARGUMENTS + Hl7v2Store resource - Cloud Healthcare API HL7v2 store to get metrics 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 hl7v2_store 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. + + HL7V2_STORE + ID of the hl7v2Store or fully qualified identifier for the + hl7v2Store. + + To set the hl7v2_store attribute: + ▸ provide the argument hl7v2_store on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --dataset=DATASET + Cloud Healthcare dataset. + + To set the dataset attribute: + ▸ provide the argument hl7v2_store on the command line with a fully + specified name; + ▸ provide the argument --dataset on the command line. + + --location=LOCATION + Google Cloud location. + + To set the location attribute: + ▸ provide the argument hl7v2_store on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property healthcare/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the healthcare/v1alpha2 API. The full documentation for + this API can be found at: https://cloud.google.com/healthcare + +NOTES + This command is currently in alpha and might change without notice. If this + command fails 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 healthcare hl7v2-stores metrics + + $ gcloud beta healthcare hl7v2-stores metrics + diff --git a/gcloud/alpha/immersive-stream/xr/instances/create b/gcloud/alpha/immersive-stream/xr/instances/create index 5327df6b3..8ea88e713 100644 --- a/gcloud/alpha/immersive-stream/xr/instances/create +++ b/gcloud/alpha/immersive-stream/xr/instances/create @@ -4,8 +4,11 @@ NAME SYNOPSIS gcloud alpha immersive-stream xr instances create INSTANCE - --add-region=[capacity=CAPACITY],[region=REGION] --version=VERSION - (--content=CONTENT : --location=LOCATION) [--async] + --add-region=[autoscaling_buffer=AUTOSCALING_BUFFER], + [autoscaling_min_capacity=AUTOSCALING_MIN_CAPACITY], + [capacity=CAPACITY], + [enable_autoscaling=ENABLE_AUTOSCALING],[region=REGION] + --version=VERSION (--content=CONTENT : --location=LOCATION) [--async] [--fallback-url=FALLBACK_URL] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -38,7 +41,7 @@ POSITIONAL ARGUMENTS Name of the instance to be created REQUIRED FLAGS - --add-region=[capacity=CAPACITY],[region=REGION] + --add-region=[autoscaling_buffer=AUTOSCALING_BUFFER],[autoscaling_min_capacity=AUTOSCALING_MIN_CAPACITY],[capacity=CAPACITY],[enable_autoscaling=ENABLE_AUTOSCALING],[region=REGION] Flag used to specify region and capacity required for the service instance's availability. diff --git a/gcloud/alpha/immersive-stream/xr/instances/update b/gcloud/alpha/immersive-stream/xr/instances/update index 73f045cd8..816abb026 100644 --- a/gcloud/alpha/immersive-stream/xr/instances/update +++ b/gcloud/alpha/immersive-stream/xr/instances/update @@ -5,9 +5,15 @@ NAME SYNOPSIS gcloud alpha immersive-stream xr instances update (INSTANCE : --location=LOCATION) - (--add-region=[capacity=CAPACITY],[region=REGION] + (--add-region=[autoscaling_buffer=AUTOSCALING_BUFFER], + [autoscaling_min_capacity=AUTOSCALING_MIN_CAPACITY], + [capacity=CAPACITY], + [enable_autoscaling=ENABLE_AUTOSCALING],[region=REGION] | --fallback-url=FALLBACK_URL | --remove-region=REMOVE_REGION - | --update-region=[capacity=CAPACITY],[region=REGION] + | --update-region=[autoscaling_buffer=AUTOSCALING_BUFFER], + [autoscaling_min_capacity=AUTOSCALING_MIN_CAPACITY], + [capacity=CAPACITY], + [enable_autoscaling=ENABLE_AUTOSCALING],[region=REGION] | --version=VERSION) [--async] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -89,7 +95,7 @@ REQUIRED FLAGS Exactly one of these must be specified: - --add-region=[capacity=CAPACITY],[region=REGION] + --add-region=[autoscaling_buffer=AUTOSCALING_BUFFER],[autoscaling_min_capacity=AUTOSCALING_MIN_CAPACITY],[capacity=CAPACITY],[enable_autoscaling=ENABLE_AUTOSCALING],[region=REGION] Flag used to specify region and capacity required for the service instance's availability. @@ -105,7 +111,7 @@ REQUIRED FLAGS --remove-region=REMOVE_REGION Region to remove - --update-region=[capacity=CAPACITY],[region=REGION] + --update-region=[autoscaling_buffer=AUTOSCALING_BUFFER],[autoscaling_min_capacity=AUTOSCALING_MIN_CAPACITY],[capacity=CAPACITY],[enable_autoscaling=ENABLE_AUTOSCALING],[region=REGION] Flag used to specify region and capacity required for the service instance's availability. diff --git a/gcloud/alpha/monitoring/help b/gcloud/alpha/monitoring/help index a985cc5a5..d53731c7a 100644 --- a/gcloud/alpha/monitoring/help +++ b/gcloud/alpha/monitoring/help @@ -1,6 +1,6 @@ NAME gcloud alpha monitoring - manage Cloud Monitoring alerting policies, - dashboards, and notification channels + dashboards, notification channels, and uptime checks SYNOPSIS gcloud alpha monitoring GROUP [GCLOUD_WIDE_FLAG ...] @@ -14,6 +14,7 @@ DESCRIPTION ▪ https://cloud.google.com/monitoring/alerts/using-alerting-api ▪ https://cloud.google.com/monitoring/alerts/using-channels-api ▪ https://cloud.google.com/monitoring/dashboards/api-dashboard + ▪ https://cloud.google.com/monitoring/uptime-checks/manage#api GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -41,6 +42,9 @@ GROUPS snoozes (ALPHA) Manage Cloud Monitoring snoozes. + uptime + (ALPHA) Manage Cloud Monitoring uptime checks. + NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct diff --git a/gcloud/alpha/monitoring/uptime/help b/gcloud/alpha/monitoring/uptime/help new file mode 100644 index 000000000..338646250 --- /dev/null +++ b/gcloud/alpha/monitoring/uptime/help @@ -0,0 +1,29 @@ +NAME + gcloud alpha monitoring uptime - manage Cloud Monitoring uptime checks + +SYNOPSIS + gcloud alpha monitoring uptime COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Monitoring uptime checks. + + More information can be found here: + https://cloud.google.com/monitoring/api/v3/ + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + list-ips + (ALPHA) List uptime check egress ips. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails 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/monitoring/uptime/list-ips b/gcloud/alpha/monitoring/uptime/list-ips new file mode 100644 index 000000000..4c75ee1ae --- /dev/null +++ b/gcloud/alpha/monitoring/uptime/list-ips @@ -0,0 +1,35 @@ +NAME + gcloud alpha monitoring uptime list-ips - list uptime check egress ips + +SYNOPSIS + gcloud alpha monitoring uptime list-ips [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List uptime check egress ips. + +EXAMPLES + To see all uptime check egress ips: + + $ gcloud alpha monitoring uptime list-ips + + More information can be found at + https://cloud.google.com/monitoring/uptime-checks/using-uptime-checks + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the monitoring/v3 API. The full documentation for this + API can be found at: https://cloud.google.com/monitoring/api/ + +NOTES + This command is currently in alpha and might change without notice. If this + command fails 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/netapp/active-directories/create b/gcloud/alpha/netapp/active-directories/create index 8f5a3b02c..befe5e4be 100644 --- a/gcloud/alpha/netapp/active-directories/create +++ b/gcloud/alpha/netapp/active-directories/create @@ -61,8 +61,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument active_directory on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. REQUIRED FLAGS --dns=DNS diff --git a/gcloud/alpha/netapp/active-directories/delete b/gcloud/alpha/netapp/active-directories/delete index cb9d58e1b..3cea4fac5 100644 --- a/gcloud/alpha/netapp/active-directories/delete +++ b/gcloud/alpha/netapp/active-directories/delete @@ -53,8 +53,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument active_directory on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async diff --git a/gcloud/alpha/netapp/active-directories/describe b/gcloud/alpha/netapp/active-directories/describe index b4f0e3e51..4147f253c 100644 --- a/gcloud/alpha/netapp/active-directories/describe +++ b/gcloud/alpha/netapp/active-directories/describe @@ -47,8 +47,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument active_directory on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/netapp/active-directories/list b/gcloud/alpha/netapp/active-directories/list index 7d2dd408a..440b58994 100644 --- a/gcloud/alpha/netapp/active-directories/list +++ b/gcloud/alpha/netapp/active-directories/list @@ -25,7 +25,6 @@ FLAGS specified name; ◆ uses all locations by default. with a fully specified name; ◆ set the property netapp/location with a fully specified name; - ◆ set the property netapp/region with a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. @@ -35,8 +34,7 @@ FLAGS To set the location attribute: ▸ provide the argument --location on the command line; ▸ uses all locations by default.; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/alpha/netapp/active-directories/update b/gcloud/alpha/netapp/active-directories/update index 3f646c4f3..14638ed97 100644 --- a/gcloud/alpha/netapp/active-directories/update +++ b/gcloud/alpha/netapp/active-directories/update @@ -63,8 +63,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument active_directory on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. REQUIRED FLAGS --dns=DNS diff --git a/gcloud/alpha/netapp/operations/describe b/gcloud/alpha/netapp/operations/describe index 48ad843e4..b2ac6afab 100644 --- a/gcloud/alpha/netapp/operations/describe +++ b/gcloud/alpha/netapp/operations/describe @@ -45,8 +45,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument operation on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/netapp/operations/list b/gcloud/alpha/netapp/operations/list index edd64ee61..8fd7b2f90 100644 --- a/gcloud/alpha/netapp/operations/list +++ b/gcloud/alpha/netapp/operations/list @@ -24,7 +24,6 @@ FLAGS specified name; ◆ uses all locations by default. with a fully specified name; ◆ set the property netapp/location with a fully specified name; - ◆ set the property netapp/region with a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. @@ -34,8 +33,7 @@ FLAGS To set the location attribute: ▸ provide the argument --location on the command line; ▸ uses all locations by default.; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/alpha/netapp/storage-pools/create b/gcloud/alpha/netapp/storage-pools/create index 84339f1e2..5c31d2feb 100644 --- a/gcloud/alpha/netapp/storage-pools/create +++ b/gcloud/alpha/netapp/storage-pools/create @@ -56,8 +56,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument storage_pool on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. REQUIRED FLAGS --capacity=CAPACITY @@ -111,8 +110,7 @@ OPTIONAL FLAGS ◆ provide the argument --active-directory on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --active-directory=ACTIVE_DIRECTORY ID of the active_directory or fully qualified identifier for the @@ -146,8 +144,7 @@ OPTIONAL FLAGS ◆ provide the argument --kms-config on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --kms-config=KMS_CONFIG ID of the kms_config or fully qualified identifier for the diff --git a/gcloud/alpha/netapp/storage-pools/delete b/gcloud/alpha/netapp/storage-pools/delete index 0f3b6f6b2..371ec126d 100644 --- a/gcloud/alpha/netapp/storage-pools/delete +++ b/gcloud/alpha/netapp/storage-pools/delete @@ -52,8 +52,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument storage_pool on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async diff --git a/gcloud/alpha/netapp/storage-pools/describe b/gcloud/alpha/netapp/storage-pools/describe index 88150f21b..4ef88e2dc 100644 --- a/gcloud/alpha/netapp/storage-pools/describe +++ b/gcloud/alpha/netapp/storage-pools/describe @@ -47,8 +47,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument storage_pool on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/netapp/storage-pools/list b/gcloud/alpha/netapp/storage-pools/list index 7ea144db0..27ec949c3 100644 --- a/gcloud/alpha/netapp/storage-pools/list +++ b/gcloud/alpha/netapp/storage-pools/list @@ -24,7 +24,6 @@ FLAGS specified name; ◆ uses all locations by default. with a fully specified name; ◆ set the property netapp/location with a fully specified name; - ◆ set the property netapp/region with a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. @@ -34,8 +33,7 @@ FLAGS To set the location attribute: ▸ provide the argument --location on the command line; ▸ uses all locations by default.; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/alpha/netapp/storage-pools/update b/gcloud/alpha/netapp/storage-pools/update index eeed9bef3..88e0375ef 100644 --- a/gcloud/alpha/netapp/storage-pools/update +++ b/gcloud/alpha/netapp/storage-pools/update @@ -51,8 +51,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument storage_pool on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS Active directory resource - The Active Directory to attach to the Storage @@ -69,8 +68,7 @@ FLAGS ◆ provide the argument --active-directory on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --active-directory=ACTIVE_DIRECTORY ID of the active_directory or fully qualified identifier for the diff --git a/gcloud/alpha/netapp/volumes/create b/gcloud/alpha/netapp/volumes/create index 860cf915a..5d2c4e6f8 100644 --- a/gcloud/alpha/netapp/volumes/create +++ b/gcloud/alpha/netapp/volumes/create @@ -81,8 +81,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument volume on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. REQUIRED FLAGS --capacity=CAPACITY @@ -110,8 +109,7 @@ REQUIRED FLAGS ◆ provide the argument --storage-pool on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. This must be specified. @@ -175,8 +173,10 @@ OPTIONAL FLAGS CONTINUOUSLY_AVAILABLE. --snap-reserve=SNAP_RESERVE - The percentage of volume storage reserved for snapshot storage. The - default value for this is 0 percent + (DEPRECATED) The percentage of volume storage reserved for snapshot + storage. The default value for this is 0 percent + + The snap-reserve option is deprecated --snapshot-daily=[hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP] Make a snapshot every day e.g. at 06:00, 05:20, 23:50 @@ -209,8 +209,7 @@ OPTIONAL FLAGS To set the location attribute: ◆ provide the argument --source-snapshot on the command line with a fully specified name; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. To set the volume attribute: ◆ provide the argument --source-snapshot on the command line with a diff --git a/gcloud/alpha/netapp/volumes/delete b/gcloud/alpha/netapp/volumes/delete index 07d0348a2..8cd7e0b70 100644 --- a/gcloud/alpha/netapp/volumes/delete +++ b/gcloud/alpha/netapp/volumes/delete @@ -47,8 +47,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument volume on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async diff --git a/gcloud/alpha/netapp/volumes/describe b/gcloud/alpha/netapp/volumes/describe index 502590513..308116e74 100644 --- a/gcloud/alpha/netapp/volumes/describe +++ b/gcloud/alpha/netapp/volumes/describe @@ -43,8 +43,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument volume on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/netapp/volumes/list b/gcloud/alpha/netapp/volumes/list index afe76c5f4..788f30b27 100644 --- a/gcloud/alpha/netapp/volumes/list +++ b/gcloud/alpha/netapp/volumes/list @@ -24,7 +24,6 @@ FLAGS specified name; ◆ uses all locations by default. with a fully specified name; ◆ set the property netapp/location with a fully specified name; - ◆ set the property netapp/region with a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. @@ -34,8 +33,7 @@ FLAGS To set the location attribute: ▸ provide the argument --location on the command line; ▸ uses all locations by default.; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/alpha/netapp/volumes/revert b/gcloud/alpha/netapp/volumes/revert index b9e27bd15..293fa8e9f 100644 --- a/gcloud/alpha/netapp/volumes/revert +++ b/gcloud/alpha/netapp/volumes/revert @@ -45,8 +45,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument volume on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. REQUIRED FLAGS Snapshot resource - The Snapshot to revert the Volume back to. This @@ -62,8 +61,7 @@ REQUIRED FLAGS To set the location attribute: ◆ provide the argument --snapshot on the command line with a fully specified name; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. To set the volume attribute: ◆ provide the argument --snapshot on the command line with a fully diff --git a/gcloud/alpha/netapp/volumes/snapshots/create b/gcloud/alpha/netapp/volumes/snapshots/create index 0ef7323c3..65544c448 100644 --- a/gcloud/alpha/netapp/volumes/snapshots/create +++ b/gcloud/alpha/netapp/volumes/snapshots/create @@ -52,8 +52,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument snapshot on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async @@ -85,8 +84,7 @@ FLAGS ◆ provide the argument --volume on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --volume=VOLUME ID of the volume or fully qualified identifier for the volume. diff --git a/gcloud/alpha/netapp/volumes/snapshots/delete b/gcloud/alpha/netapp/volumes/snapshots/delete index 6958571df..6d74f275f 100644 --- a/gcloud/alpha/netapp/volumes/snapshots/delete +++ b/gcloud/alpha/netapp/volumes/snapshots/delete @@ -57,8 +57,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument snapshot on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async @@ -79,8 +78,7 @@ FLAGS ◆ provide the argument --volume on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --volume=VOLUME ID of the volume or fully qualified identifier for the volume. diff --git a/gcloud/alpha/netapp/volumes/snapshots/describe b/gcloud/alpha/netapp/volumes/snapshots/describe index f0bd7cb28..e121a366c 100644 --- a/gcloud/alpha/netapp/volumes/snapshots/describe +++ b/gcloud/alpha/netapp/volumes/snapshots/describe @@ -52,8 +52,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument snapshot on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS Volume resource - The Volume to take a Snapshot of. This represents a @@ -70,8 +69,7 @@ FLAGS ◆ provide the argument --volume on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --volume=VOLUME ID of the volume or fully qualified identifier for the volume. diff --git a/gcloud/alpha/netapp/volumes/snapshots/list b/gcloud/alpha/netapp/volumes/snapshots/list index 3144fd5ef..d017cca2b 100644 --- a/gcloud/alpha/netapp/volumes/snapshots/list +++ b/gcloud/alpha/netapp/volumes/snapshots/list @@ -27,7 +27,6 @@ FLAGS specified name; ◆ uses all locations by default. with a fully specified name; ◆ set the property netapp/location with a fully specified name; - ◆ set the property netapp/region with a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. @@ -37,8 +36,7 @@ FLAGS To set the location attribute: ▸ provide the argument --location on the command line; ▸ uses all locations by default.; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. Volume resource - The Volume to take a Snapshot of. This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this @@ -54,8 +52,7 @@ FLAGS ◆ provide the argument --volume on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --volume=VOLUME ID of the volume or fully qualified identifier for the volume. diff --git a/gcloud/alpha/netapp/volumes/snapshots/update b/gcloud/alpha/netapp/volumes/snapshots/update index f8ea0ed6e..22cdc3fd7 100644 --- a/gcloud/alpha/netapp/volumes/snapshots/update +++ b/gcloud/alpha/netapp/volumes/snapshots/update @@ -54,8 +54,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument snapshot on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async @@ -88,8 +87,7 @@ FLAGS ◆ provide the argument --volume on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --volume=VOLUME ID of the volume or fully qualified identifier for the volume. diff --git a/gcloud/alpha/netapp/volumes/update b/gcloud/alpha/netapp/volumes/update index 4f4000b17..a13b67aa8 100644 --- a/gcloud/alpha/netapp/volumes/update +++ b/gcloud/alpha/netapp/volumes/update @@ -73,8 +73,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument volume on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async @@ -132,8 +131,10 @@ FLAGS CONTINUOUSLY_AVAILABLE. --snap-reserve=SNAP_RESERVE - The percentage of volume storage reserved for snapshot storage. The - default value for this is 0 percent + (DEPRECATED) The percentage of volume storage reserved for snapshot + storage. The default value for this is 0 percent + + The snap-reserve option is deprecated --snapshot-daily=[hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP] Make a snapshot every day e.g. at 06:00, 05:20, 23:50 @@ -166,8 +167,7 @@ FLAGS To set the location attribute: ◆ provide the argument --source-snapshot on the command line with a fully specified name; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. To set the volume attribute: ◆ provide the argument --source-snapshot on the command line with a @@ -193,8 +193,7 @@ FLAGS ◆ provide the argument --storage-pool on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --storage-pool=STORAGE_POOL ID of the storage_pool or fully qualified identifier for the diff --git a/gcloud/alpha/network-security/firewall-endpoints/create b/gcloud/alpha/network-security/firewall-endpoints/create index bb55b4fb3..244e9d39c 100644 --- a/gcloud/alpha/network-security/firewall-endpoints/create +++ b/gcloud/alpha/network-security/firewall-endpoints/create @@ -4,9 +4,9 @@ NAME SYNOPSIS gcloud alpha network-security firewall-endpoints create - (FIREWALL_ENDPOINT : --organization=ORGANIZATION --zone=ZONE) [--async] - [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] - [--max-wait=MAX_WAIT; default="60m"] + (FIREWALL_ENDPOINT : --organization=ORGANIZATION --zone=ZONE) + --billing-project=BILLING_PROJECT [--async] [--description=DESCRIPTION] + [--labels=[KEY=VALUE,...]] [--max-wait=MAX_WAIT; default="60m"] [--target-firewall-attachment=TARGET_FIREWALL_ATTACHMENT] [GCLOUD_WIDE_FLAG ...] @@ -56,7 +56,13 @@ POSITIONAL ARGUMENTS fully specified name; ▸ provide the argument --zone on the command line. -FLAGS +REQUIRED FLAGS + --billing-project=BILLING_PROJECT + The Google Cloud project ID to use for API enablement check, quota, and + endpoint uptime billing. Overrides the default billing/quota_project + property value for this command invocation. + +OPTIONAL FLAGS --async Return immediately, without waiting for the operation in progress to complete. The default is True. Enabled by default, use --no-async to diff --git a/gcloud/alpha/network-security/firewall-endpoints/update b/gcloud/alpha/network-security/firewall-endpoints/update index 936cf2955..a28d4586d 100644 --- a/gcloud/alpha/network-security/firewall-endpoints/update +++ b/gcloud/alpha/network-security/firewall-endpoints/update @@ -6,6 +6,7 @@ SYNOPSIS gcloud alpha network-security firewall-endpoints update (FIREWALL_ENDPOINT : --organization=ORGANIZATION --zone=ZONE) [--async] [--description=DESCRIPTION] [--max-wait=MAX_WAIT; default="60m"] + [--update-billing-project=BILLING_PROJECT] [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] @@ -81,6 +82,11 @@ FLAGS specified. See $ gcloud topic datetimes for information on time formats. + --update-billing-project=BILLING_PROJECT + The Google Cloud project ID to use for API enablement check, quota, and + endpoint uptime billing. Overrides the default billing/quota_project + property value for this command invocation. + --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/alpha/pubsub/subscriptions/create b/gcloud/alpha/pubsub/subscriptions/create index 725d4ad07..15c516391 100644 --- a/gcloud/alpha/pubsub/subscriptions/create +++ b/gcloud/alpha/pubsub/subscriptions/create @@ -13,8 +13,8 @@ SYNOPSIS [--push-auth-token-audience=OPTIONAL_AUDIENCE_OVERRIDE] [--push-endpoint=PUSH_ENDPOINT] [--retain-acked-messages] [[--bigquery-table=BIGQUERY_TABLE - : --drop-unknown-fields --use-topic-schema --write-metadata] - | [--cloud-storage-bucket=CLOUD_STORAGE_BUCKET + : --drop-unknown-fields --write-metadata --use-table-schema + | --use-topic-schema] | [--cloud-storage-bucket=CLOUD_STORAGE_BUCKET : --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX --cloud-storage-max-bytes=CLOUD_STORAGE_MAX_BYTES @@ -166,16 +166,10 @@ OPTIONAL FLAGS in this group are specified. --drop-unknown-fields - When --use-topic-schema is set, whether or not to ignore fields in - the topic schema that do not appear in the BigQuery schema. If - false, then the BigQuery schema must contain all fields that are - also present in the topic schema. Use --no-drop-unknown-fields to - disable this flag. - - --use-topic-schema - Whether or not to use the schema for the subscription's topic (if - it exists) when writing messages to BigQuery. Use - --no-use-topic-schema to disable this flag. + If either --use-topic-schema or --use-table-schema is set, whether + or not to ignore fields in the message that do not appear in the + BigQuery table schema. Use --no-drop-unknown-fields to disable this + flag. --write-metadata Whether or not to write message metadata including message ID, @@ -186,6 +180,20 @@ OPTIONAL FLAGS JSON object in the attributes column. Use --no-write-metadata to disable this flag. + At most one of these can be specified: + + --use-table-schema + Whether or not to use the BigQuery table schema when writing + messages to BigQuery. Use --no-use-table-schema to disable this + flag. + + --use-topic-schema + Whether or not to use the schema for the subscription's topic (if + it exists) when writing messages to BigQuery. If + --drop-unknown-fields is not set, then the BigQuery schema must + contain all fields that are present in the topic schema. Use + --no-use-topic-schema to disable this flag. + Cloud Storage Config Options. The Cloud Pub/Sub service account associated with the enclosing subscription's parent project (i.e., service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must diff --git a/gcloud/alpha/pubsub/subscriptions/update b/gcloud/alpha/pubsub/subscriptions/update index 844e3c2d4..e5147d9bc 100644 --- a/gcloud/alpha/pubsub/subscriptions/update +++ b/gcloud/alpha/pubsub/subscriptions/update @@ -12,8 +12,8 @@ SYNOPSIS [--push-endpoint=PUSH_ENDPOINT] [--retain-acked-messages] [--update-labels=[KEY=VALUE,...]] [--clear-bigquery-config | [--bigquery-table=BIGQUERY_TABLE - : --drop-unknown-fields --use-topic-schema --write-metadata] - | --clear-cloud-storage-config + : --drop-unknown-fields --write-metadata --use-table-schema + | --use-topic-schema] | --clear-cloud-storage-config | [--cloud-storage-bucket=CLOUD_STORAGE_BUCKET : --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX @@ -136,17 +136,11 @@ FLAGS arguments in this group are specified. --drop-unknown-fields - When --use-topic-schema is set, whether or not to ignore fields - in the topic schema that do not appear in the BigQuery schema. If - false, then the BigQuery schema must contain all fields that are - also present in the topic schema. Use --no-drop-unknown-fields to + If either --use-topic-schema or --use-table-schema is set, + whether or not to ignore fields in the message that do not appear + in the BigQuery table schema. Use --no-drop-unknown-fields to disable this flag. - --use-topic-schema - Whether or not to use the schema for the subscription's topic (if - it exists) when writing messages to BigQuery. Use - --no-use-topic-schema to disable this flag. - --write-metadata Whether or not to write message metadata including message ID, publish timestamp, ordering key, and attributes to BigQuery. The @@ -156,6 +150,20 @@ FLAGS JSON object in the attributes column. Use --no-write-metadata to disable this flag. + At most one of these can be specified: + + --use-table-schema + Whether or not to use the BigQuery table schema when writing + messages to BigQuery. Use --no-use-table-schema to disable this + flag. + + --use-topic-schema + Whether or not to use the schema for the subscription's topic + (if it exists) when writing messages to BigQuery. If + --drop-unknown-fields is not set, then the BigQuery schema must + contain all fields that are present in the topic schema. Use + --no-use-topic-schema to disable this flag. + At most one of these can be specified: --clear-cloud-storage-config diff --git a/gcloud/alpha/pubsub/topics/create b/gcloud/alpha/pubsub/topics/create index 51867ac39..780d7b255 100644 --- a/gcloud/alpha/pubsub/topics/create +++ b/gcloud/alpha/pubsub/topics/create @@ -6,11 +6,12 @@ SYNOPSIS gcloud alpha pubsub topics create TOPIC [TOPIC ...] [--labels=[KEY=VALUE,...]] [--message-retention-duration=MESSAGE_RETENTION_DURATION] - [--message-storage-policy-allowed-regions=[REGION,...]] [--message-encoding=ENCODING (--schema=SCHEMA : --schema-project=SCHEMA_PROJECT) : --first-revision-id=FIRST_REVISION_ID --last-revision-id=LAST_REVISION_ID] + [--message-storage-policy-allowed-regions=[REGION,...] + : --message-storage-policy-enforce-in-transit] [--topic-encryption-key=TOPIC_ENCRYPTION_KEY : --topic-encryption-key-keyring=TOPIC_ENCRYPTION_KEY_KEYRING --topic-encryption-key-location=TOPIC_ENCRYPTION_KEY_LOCATION @@ -65,10 +66,6 @@ FLAGS is one of "s", "m", "h", and "d" for seconds, minutes, hours, and days, respectively. If the unit is omitted, seconds is assumed. - --message-storage-policy-allowed-regions=[REGION,...] - A list of one or more Cloud regions where messages are allowed to be - stored at rest. - Schema settings. The schema that messages published to this topic must conform to and the expected message encoding. @@ -110,6 +107,19 @@ FLAGS ▫ provide the argument --project on the command line; ▫ set the property core/project. + Options for explicitly specifying the message storage policy for a topic. + + --message-storage-policy-allowed-regions=[REGION,...] + A list of one or more Cloud regions where messages are allowed to be + stored at rest. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --message-storage-policy-enforce-in-transit + Whether or not to enforce in-transit guarantees for this topic using + the allowed regions. + Key resource - The Cloud KMS (Key Management Service) cryptokey that will be used to protect the topic. The specified Cloud KMS key should have purpose set to "ENCRYPT_DECRYPT". The service account, diff --git a/gcloud/alpha/pubsub/topics/update b/gcloud/alpha/pubsub/topics/update index 8d1e18345..e3fa98f12 100644 --- a/gcloud/alpha/pubsub/topics/update +++ b/gcloud/alpha/pubsub/topics/update @@ -11,8 +11,9 @@ SYNOPSIS : --schema-project=SCHEMA_PROJECT) : --first-revision-id=FIRST_REVISION_ID --last-revision-id=LAST_REVISION_ID]] - [--message-storage-policy-allowed-regions=[REGION,...] - | --recompute-message-storage-policy] + [--recompute-message-storage-policy + | [--message-storage-policy-allowed-regions=[REGION,...] + : --message-storage-policy-enforce-in-transit]] [--topic-encryption-key=TOPIC_ENCRYPTION_KEY : --topic-encryption-key-keyring=TOPIC_ENCRYPTION_KEY_KEYRING --topic-encryption-key-location=TOPIC_ENCRYPTION_KEY_LOCATION @@ -65,6 +66,13 @@ EXAMPLES $ gcloud alpha pubsub topics update mytopic \ --recompute-message-storage-policy + To enforce both at-rest and in-transit guarantees for messages published to + the topic, run: + + $ gcloud alpha pubsub topics update mytopic \ + --message-storage-policy-allowed-regions=some-cloud-region1,\ + some-cloud-region2 --message-storage-policy-enforce-in-transit + POSITIONAL ARGUMENTS Topic resource - Name of the topic to update. This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this group but @@ -184,14 +192,25 @@ FLAGS At most one of these can be specified: - --message-storage-policy-allowed-regions=[REGION,...] - A list of one or more Cloud regions where messages are allowed to be - stored at rest. - --recompute-message-storage-policy - If given, Cloud Pub/Sub will recompute the regions where messages can - be stored at rest, based on your organization's "Resource Location - Restriction" policy. + If given, Pub/Sub recomputes the regions where messages can be stored + at rest, based on your organization's "Resource Location Restriction" + policy. + + Options for explicitly specifying the message storage policy for a + topic. These fields can be set only if the + --recompute-message-storage-policy flag is not set. + + --message-storage-policy-allowed-regions=[REGION,...] + A list of one or more Cloud regions where messages are allowed to + be stored at rest. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --message-storage-policy-enforce-in-transit + Whether or not to enforce in-transit guarantees for this topic + using the allowed regions. Key resource - The Cloud KMS (Key Management Service) cryptokey that will be used to protect the topic. The specified Cloud KMS key should have diff --git a/gcloud/alpha/recaptcha/keys/create b/gcloud/alpha/recaptcha/keys/create index 57632361f..f820fa493 100644 --- a/gcloud/alpha/recaptcha/keys/create +++ b/gcloud/alpha/recaptcha/keys/create @@ -207,6 +207,9 @@ OPTIONAL FLAGS ca Cloud Armor + cloudflare + Cloudflare + fastly Fastly diff --git a/gcloud/alpha/recommender/insights/list b/gcloud/alpha/recommender/insights/list index 5ee88c4c8..688221f4b 100644 --- a/gcloud/alpha/recommender/insights/list +++ b/gcloud/alpha/recommender/insights/list @@ -2,16 +2,18 @@ NAME gcloud alpha recommender insights list - list insights for a cloud entity SYNOPSIS - gcloud alpha recommender insights list --location=LOCATION + gcloud alpha recommender insights list (--billing-account=BILLING_ACCOUNT | --folder=FOLDER_ID | --organization=ORGANIZATION_ID | --project=PROJECT_ID) - [--insight-type=INSIGHT_TYPE] [--filter=EXPRESSION] [--limit=LIMIT] - [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] - [GCLOUD_WIDE_FLAG ...] + [--insight-type=INSIGHT_TYPE] [--location=LOCATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) This command lists all insights for a given cloud entity, location - and insight type. Supported insight-types can be found here: + and insight type. If insight-type or location is not specified, insights + for all supported insight-types and locations are listed. Supported + insight-types can be found here: https://cloud.google.com/recommender/docs/insights/insight-types. Currently the following cloud_entity_types are supported: project, billing_account, folder and organization. @@ -19,13 +21,10 @@ DESCRIPTION EXAMPLES To list all insights for a billing account: - $ gcloud alpha recommender insights list --project=project-name \ + $ gcloud alpha recommender insights list --project=project-id \ --location=global --insight-type=google.compute.firewall.Insight REQUIRED FLAGS - --location=LOCATION - Location - Resource that is associated with cloud entity type. Currently four mutually exclusive flags are supported, --project, --billing-account, --folder, --organization. @@ -51,6 +50,10 @@ FLAGS Insight type to list insights for. Supported insight-types can be found here: https://cloud.google.com/recommender/docs/insights/insight-types + --location=LOCATION + Location to list insights for. If no location is specified, insights + for all supported locations are listed. + LIST COMMAND FLAGS --filter=EXPRESSION Apply a Boolean filter EXPRESSION to each resource item to be listed. diff --git a/gcloud/alpha/recommender/insights/mark-accepted b/gcloud/alpha/recommender/insights/mark-accepted index 9002e32ea..f3e17ef55 100644 --- a/gcloud/alpha/recommender/insights/mark-accepted +++ b/gcloud/alpha/recommender/insights/mark-accepted @@ -18,7 +18,7 @@ EXAMPLES To mark an insight as ACCEPTED: $ gcloud alpha recommender insights mark-accepted abcd-1234 \ - --project=project-name --location=global \ + --project=project-id --location=global \ --insight-type=google.compute.firewall.Insight --etag=abc123 POSITIONAL ARGUMENTS diff --git a/gcloud/alpha/recommender/insights/mark-active b/gcloud/alpha/recommender/insights/mark-active index 895e58558..2c3377c96 100644 --- a/gcloud/alpha/recommender/insights/mark-active +++ b/gcloud/alpha/recommender/insights/mark-active @@ -18,7 +18,7 @@ EXAMPLES To mark an insight as ACTIVE: $ gcloud alpha recommender insights mark-active abcd-1234 \ - --project=project-name --location=global \ + --project=project-id --location=global \ --insight-type=google.compute.firewall.Insight --etag=abc123 POSITIONAL ARGUMENTS diff --git a/gcloud/alpha/recommender/insights/mark-dismissed b/gcloud/alpha/recommender/insights/mark-dismissed index 2f70bdc33..bb5bca855 100644 --- a/gcloud/alpha/recommender/insights/mark-dismissed +++ b/gcloud/alpha/recommender/insights/mark-dismissed @@ -19,7 +19,7 @@ EXAMPLES To mark an insight as DISMISSED: $ gcloud alpha recommender insights mark-dismissed abcd-1234 \ - --project=project-name --location=global \ + --project=project-id --location=global \ --insight-type=google.compute.firewall.Insight --etag=abc123 POSITIONAL ARGUMENTS diff --git a/gcloud/alpha/recommender/recommendations/list b/gcloud/alpha/recommender/recommendations/list index ffb5ac386..d7db2c77a 100644 --- a/gcloud/alpha/recommender/recommendations/list +++ b/gcloud/alpha/recommender/recommendations/list @@ -3,29 +3,28 @@ NAME recommendation SYNOPSIS - gcloud alpha recommender recommendations list --location=LOCATION + gcloud alpha recommender recommendations list (--billing-account=BILLING_ACCOUNT | --folder=FOLDER_ID | --organization=ORGANIZATION_ID | --project=PROJECT_ID) - [--recommender=RECOMMENDER] [--filter=EXPRESSION] [--limit=LIMIT] - [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [--location=LOCATION] [--recommender=RECOMMENDER] [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) This command lists all recommendations for a given cloud_entity_id, - location and recommender. Supported recommenders can be found here: + location, and recommender. If recommender or location is not specified, + recommendations for all supported recommenders and locations are listed. + Supported recommenders can be found here: https://cloud.google.com/recommender/docs/recommenders. Currently the following cloud_entity_types are supported: project, billing_account, folder and organization. EXAMPLES Lists recommendations for a Cloud project. $ gcloud alpha recommender recommendations list \ - --project=project-name --location=global \ + --project=project-id --location=global \ --recommender=google.compute.instance.MachineTypeRecommender REQUIRED FLAGS - --location=LOCATION - Location - Resource that is associated with cloud entity type. Currently four mutually exclusive flags are supported, --project, --billing-account, --folder, --organization. @@ -47,9 +46,13 @@ REQUIRED FLAGS core/project property value for this command invocation. FLAGS + --location=LOCATION + Location to list recommendations for. If no location is specified, + recommendations for all supported locations are listed. + --recommender=RECOMMENDER Recommender to list recommendations for. If no recommender is - specified, recommendations for all supported recommenders is listed. + specified, recommendations for all supported recommenders are listed. Supported recommenders can be found here: https://cloud.google.com/recommender/docs/recommenders diff --git a/gcloud/alpha/recommender/recommendations/mark-claimed b/gcloud/alpha/recommender/recommendations/mark-claimed index 164d7d9dc..806a9e1ed 100644 --- a/gcloud/alpha/recommender/recommendations/mark-claimed +++ b/gcloud/alpha/recommender/recommendations/mark-claimed @@ -19,8 +19,8 @@ DESCRIPTION EXAMPLES To mark a recommendation as CLAIMED: - $ gcloud alpha recommender recommendations mark-claimed \ - RECOMMENDATION --project=project-name --location=global \ + $ gcloud alpha recommender recommendations mark-claimed abcd-1234 \ + --project=project-id --location=global \ --recommender=google.compute.instance.MachineTypeRecommender \ --etag=abc123 --state-metadata=key1=value1,key2=value2 diff --git a/gcloud/alpha/recommender/recommendations/mark-dismissed b/gcloud/alpha/recommender/recommendations/mark-dismissed index d42829733..13714e0f8 100644 --- a/gcloud/alpha/recommender/recommendations/mark-dismissed +++ b/gcloud/alpha/recommender/recommendations/mark-dismissed @@ -19,7 +19,7 @@ EXAMPLES To mark a recommendation as DISMISSED: $ gcloud alpha recommender recommendations mark-dismissed \ - abcd-1234 --project=project-name --location=global \ + abcd-1234 --project=project-id --location=global \ --recommender=google.compute.instance.MachineTypeRecommender \ --etag=abc123 diff --git a/gcloud/alpha/recommender/recommendations/mark-failed b/gcloud/alpha/recommender/recommendations/mark-failed index 8636bc9c8..dba020eed 100644 --- a/gcloud/alpha/recommender/recommendations/mark-failed +++ b/gcloud/alpha/recommender/recommendations/mark-failed @@ -17,7 +17,7 @@ EXAMPLES To mark a recommendation as FAILED: $ gcloud alpha recommender recommendations mark-failed abcd-1234 \ - --project=project-name --location=global \ + --project=project-id --location=global \ --recommender=google.compute.instance.MachineTypeRecommender \ --etag=abc123 --state-metadata=key1=value1,key2=value2 diff --git a/gcloud/alpha/recommender/recommendations/mark-succeeded b/gcloud/alpha/recommender/recommendations/mark-succeeded index f46f70e45..581d2009e 100644 --- a/gcloud/alpha/recommender/recommendations/mark-succeeded +++ b/gcloud/alpha/recommender/recommendations/mark-succeeded @@ -17,7 +17,7 @@ EXAMPLES To mark a recommendation as SUCCEEDED: $ gcloud alpha recommender recommendations mark-succeeded \ - abcd-1234 --project=project-name --location=global \ + abcd-1234 --project=project-id --location=global \ --recommender=google.compute.instance.MachineTypeRecommender \ --etag=abc123 --state-metadata=key1=value1,key2=value2 diff --git a/gcloud/alpha/scc/custom-modules/etd/create b/gcloud/alpha/scc/custom-modules/etd/create index d965920aa..a24c0de0a 100644 --- a/gcloud/alpha/scc/custom-modules/etd/create +++ b/gcloud/alpha/scc/custom-modules/etd/create @@ -6,7 +6,8 @@ SYNOPSIS gcloud alpha scc custom-modules etd create --custom-config-from-file=CUSTOM_CONFIG_FROM_FILE --display-name=DISPLAY_NAME --enablement-state=ENABLEMENT_STATE - --module-type=MODULE_TYPE [--organization=ORGANIZATION] + --module-type=MODULE_TYPE + [--folder=FOLDER | --organization=ORGANIZATION | --project=PROJECT] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -23,6 +24,22 @@ EXAMPLES --enablement-state="ENABLED" \ --custom-config-from-file=config.json + To create an Event Threat Detection custom module for folder 456, run: + + $ gcloud alpha scc custom-modules etd create --folder=folders/456 \ + --display-name="test_display_name" \ + --module-type="CONFIGURABLE_BAD_IP" \ + --enablement-state="ENABLED" \ + --custom-config-from-file=config.json + + To create an Event Threat Detection custom module for project 789, run: + + $ gcloud alpha scc custom-modules etd create \ + --project=projects/789 --display-name="test_display_name" \ + --module-type="CONFIGURABLE_BAD_IP" \ + --enablement-state="ENABLED" \ + --custom-config-from-file=config.json + REQUIRED FLAGS --custom-config-from-file=CUSTOM_CONFIG_FROM_FILE Path to a JSON file that contains the configuration for the Event @@ -45,9 +62,19 @@ REQUIRED FLAGS Sets the module type of the Event Threat Detection custom module. OPTIONAL FLAGS - --organization=ORGANIZATION - Organization where the Event Threat Detection custom module resides. - Formatted as organizations/123 or just 123. + At most one of these can be specified: + + --folder=FOLDER + Folder where the Event Threat Detection custom module resides. + Formatted as folders/456 or just 456. + + --organization=ORGANIZATION + Organization where the Event Threat Detection custom module resides. + Formatted as organizations/123 or just 123. + + --project=PROJECT + ID or number of the project where the Event Threat Detection custom + module resides. Formatted as projects/789 or just 789. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/scc/custom-modules/etd/delete b/gcloud/alpha/scc/custom-modules/etd/delete index a95233f1f..f8c82d483 100644 --- a/gcloud/alpha/scc/custom-modules/etd/delete +++ b/gcloud/alpha/scc/custom-modules/etd/delete @@ -4,7 +4,8 @@ NAME SYNOPSIS gcloud alpha scc custom-modules etd delete CUSTOM_MODULE - [--organization=ORGANIZATION] [GCLOUD_WIDE_FLAG ...] + [--folder=FOLDER | --organization=ORGANIZATION | --project=PROJECT] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Delete an Event Threat Detection custom module. @@ -16,6 +17,18 @@ EXAMPLES $ gcloud alpha scc custom-modules etd delete 123456 \ --organization=organizations/123 + To delete an Event Threat Detection custom module with ID 123456 for folder + 456, run: + + $ gcloud alpha scc custom-modules etd delete 123456 \ + --folder=folders/456 + + To delete an Event Threat Detection custom module with ID 123456 for + project 789, run: + + $ gcloud alpha scc custom-modules etd delete 123456 \ + --project=projects/789 + POSITIONAL ARGUMENTS CUSTOM_MODULE ID or the full resource name of the Event Threat Detection custom @@ -23,9 +36,19 @@ POSITIONAL ARGUMENTS specify the --organization, --folder, or --project flags. FLAGS - --organization=ORGANIZATION - Organization where the Event Threat Detection custom module resides. - Formatted as organizations/123 or just 123. + At most one of these can be specified: + + --folder=FOLDER + Folder where the Event Threat Detection custom module resides. + Formatted as folders/456 or just 456. + + --organization=ORGANIZATION + Organization where the Event Threat Detection custom module resides. + Formatted as organizations/123 or just 123. + + --project=PROJECT + ID or number of the project where the Event Threat Detection custom + module resides. Formatted as projects/789 or just 789. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/scc/custom-modules/etd/get b/gcloud/alpha/scc/custom-modules/etd/get index 52cc025a6..6c548d5e4 100644 --- a/gcloud/alpha/scc/custom-modules/etd/get +++ b/gcloud/alpha/scc/custom-modules/etd/get @@ -4,18 +4,36 @@ NAME SYNOPSIS gcloud alpha scc custom-modules etd get CUSTOM_MODULE - [--organization=ORGANIZATION] [GCLOUD_WIDE_FLAG ...] + [--folder=FOLDER | --organization=ORGANIZATION | --project=PROJECT] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Get the details of an Event Threat Detection custom module. + (ALPHA) Get the details of an Event Threat Detection custom module. It does + not resolve INHERITED enablement states to ENABLED or DISABLED for modules + created at ancestor levels. For example, if the module is enabled at the + ancestor level, modules for all child resources will have the enablement + state set to INHERITED. Use gcloud alpha scc custom-modules etd + get-effective to retrieve a custom module with its effective enablement + state. EXAMPLES - To get the details of a Event Threat Detection custom module with ID 123456 - for organization 123, run: + To get the details of an Event Threat Detection custom module with ID + 123456 for organization 123, run: $ gcloud alpha scc custom-modules etd get 123456 \ --organization=organizations/123 + To get the details of an Event Threat Detection custom module with ID + 123456 for folder 456, run: + + $ gcloud alpha scc custom-modules etd get 123456 --folder=folders/456 + + To get the details of an Event Threat Detection custom module with ID + 123456 for project 789, run: + + $ gcloud alpha scc custom-modules etd get 123456 \ + --project=projects/789 + POSITIONAL ARGUMENTS CUSTOM_MODULE ID or the full resource name of the Event Threat Detection custom @@ -23,9 +41,19 @@ POSITIONAL ARGUMENTS specify the --organization, --folder, or --project flags. FLAGS - --organization=ORGANIZATION - Organization from which to get the custom module details. Formatted as - organizations/123 or just 123. + At most one of these can be specified: + + --folder=FOLDER + Folder from which to get the custom module details. Formatted as + folders/456 or just 456. + + --organization=ORGANIZATION + Organization from which to get the custom module details. Formatted + as organizations/123 or just 123. + + --project=PROJECT + ID or number of the project from which to get the custom module + details. Formatted as projects/789 or just 789. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/scc/custom-modules/etd/get-effective b/gcloud/alpha/scc/custom-modules/etd/get-effective new file mode 100644 index 000000000..9777f75b0 --- /dev/null +++ b/gcloud/alpha/scc/custom-modules/etd/get-effective @@ -0,0 +1,75 @@ +NAME + gcloud alpha scc custom-modules etd get-effective - get the details of a + Event Threat Detection custom module with effective enablement state + +SYNOPSIS + gcloud alpha scc custom-modules etd get-effective CUSTOM_MODULE + [--folder=FOLDER | --organization=ORGANIZATION | --project=PROJECT] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Get the details of a Event Threat Detection custom module. For + inherited custom modules, the get-effective command resolves INHERITED + enablement states to ENABLED or DISABLED. For example, if an inherited + custom module is enabled at the ancestor level, then the get-effective + command displays the enablement state as ENABLED instead of INHERITED in a + child folder or project. + +EXAMPLES + To get the details of a Event Threat Detection custom module 123456 with + its effective enablement state from organization 123, run: + + $ gcloud alpha scc custom-modules etd get-effective 123456 \ + --organization=organizations/123 + + To get the details of a Event Threat Detection custom module 123456 with + its effective enablement state from folder 456, run: + + $ gcloud alpha scc custom-modules etd get-effective 123456 \ + --folder=folders/456 + + To get the details of a Event Threat Detection custom module 123456 with + its effective enablement state from project 789, run: + + $ gcloud alpha scc custom-modules etd get-effective 123456 \ + --project=projects/789 + +POSITIONAL ARGUMENTS + CUSTOM_MODULE + ID or the full resource name of the effective Event Threat Detection + custom module. If you specify the full resource name, you do not need + to specify the --organization, --folder, or --project flags. + +FLAGS + At most one of these can be specified: + + --folder=FOLDER + Folder from which to get the custom module details. Formatted as + folders/456 or just 456. + + --organization=ORGANIZATION + Organization from which to get the custom module details. Formatted + as organizations/123 or just 123. + + --project=PROJECT + ID or number of the project from which to get the custom module + details. Formatted as projects/789 or just 789. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the securitycenter/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/security-command-center + +NOTES + This command is currently in alpha and might change without notice. If this + command fails 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/scc/custom-modules/etd/help b/gcloud/alpha/scc/custom-modules/etd/help index 812fb8163..2ebc66849 100644 --- a/gcloud/alpha/scc/custom-modules/etd/help +++ b/gcloud/alpha/scc/custom-modules/etd/help @@ -24,9 +24,21 @@ COMMANDS get (ALPHA) Get the details of an Event Threat Detection custom module. + get-effective + (ALPHA) Get the details of a Event Threat Detection custom module with + effective enablement state. + list (ALPHA) List the details of Event Threat Detection custom modules. + list-descendant + (ALPHA) List the details of resident and descendant Event Threat + Detection custom modules. + + list-effective + (ALPHA) List the details of Event Threat Detection custom modules with + effective enablement states. + update (ALPHA) Update an Event Threat Detection custom module. diff --git a/gcloud/alpha/scc/custom-modules/etd/list b/gcloud/alpha/scc/custom-modules/etd/list index 01ce0977a..afa07f75f 100644 --- a/gcloud/alpha/scc/custom-modules/etd/list +++ b/gcloud/alpha/scc/custom-modules/etd/list @@ -3,13 +3,19 @@ NAME Detection custom modules SYNOPSIS - gcloud alpha scc custom-modules etd list --organization=ORGANIZATION + gcloud alpha scc custom-modules etd list + (--folder=FOLDER | --organization=ORGANIZATION | --project=PROJECT) [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) List the details of the Event Threat Detection custom modules for - the specified organization. + (ALPHA) List the details of the resident and inherited Event Threat + Detection custom modules for the specified folder or project. For an + organization, this command lists only the custom modules that were created + at the organization level. Custom modules created in child folders or + projects are not included in the list. To list the resident custom modules + and the modules that are created in child folders or projects, use gcloud + alpha scc custom-modules etd list-descendant. EXAMPLES To list Event Threat Detection custom modules for organization 123, run: @@ -17,11 +23,33 @@ EXAMPLES $ gcloud alpha scc custom-modules etd list \ --organization=organizations/123 + To list resident and inherited Event Threat Detection custom modules for + folder 456, run: + + $ gcloud alpha scc custom-modules etd list --folder=folders/456 + + To list resident and inherited Event Threat Detection custom modules for + project 789, run: + + $ gcloud alpha scc custom-modules etd list --project=projects/789 + REQUIRED FLAGS - --organization=ORGANIZATION - Organization for listing the Event Threat Detection custom modules - created at the organization level. Formatted as organizations/123 or - just 123. + Exactly one of these must be specified: + + --folder=FOLDER + Folder for listing the Event Threat Detection custom modules created + at the current folder level and inherited modules from CRM ancestors. + Formatted as folders/456 or just 456. + + --organization=ORGANIZATION + Organization for listing the Event Threat Detection custom modules + created at the organization level. Formatted as organizations/123 or + just 123. + + --project=PROJECT + ID or number of the project for listing the Event Threat Detections + custom modules created at current project level and inherited modules + from CRM ancestors. Formatted as projects/789 or just 789. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/alpha/scc/custom-modules/etd/list-descendant b/gcloud/alpha/scc/custom-modules/etd/list-descendant new file mode 100644 index 000000000..924a678c2 --- /dev/null +++ b/gcloud/alpha/scc/custom-modules/etd/list-descendant @@ -0,0 +1,100 @@ +NAME + gcloud alpha scc custom-modules etd list-descendant - list the details of + resident and descendant Event Threat Detection custom modules + +SYNOPSIS + gcloud alpha scc custom-modules etd list-descendant + (--folder=FOLDER | --organization=ORGANIZATION | --project=PROJECT) + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List the details of the resident and descendant Event Threat + Detection custom modules for a specified organization or folder. For a + project, this command lists only the custom modules that are created in the + project. Modules created in a parent organization or folder are excluded + from the list. To list the resident custom modules and the modules that are + inherited from a parent organization and folder, use gcloud scc + custom-modules etd list. + +EXAMPLES + To list resident and descendant Event Threat Detection custom modules for + organization 123, run: + + $ gcloud alpha scc custom-modules etd list-descendant \ + --organization=organizations/123 + + To list resident and descendant Event Threat Detection custom modules for + folder 456, run: + + $ gcloud alpha scc custom-modules etd list-descendant \ + --folder=folders/456 + + To list resident and descendant Event Threat Detection custom modules for + project 789, run: + + $ gcloud alpha scc custom-modules etd list-descendant \ + --project=projects/789 + +REQUIRED FLAGS + Exactly one of these must be specified: + + --folder=FOLDER + Folder for listing the Event Threat Detection custom modules created + at the current folder level and its child resources. Formatted as + folders/456 or just 456. + + --organization=ORGANIZATION + Organization for listing the Event Threat Detection custom modules + created at the organization level and its child resources. Formatted + as organizations/123 or just 123. + + --project=PROJECT + ID or number of the project for listing the Event Threat Detection + custom modules at current project level. Formatted as projects/789 or + just 789. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the securitycenter/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/security-command-center + +NOTES + This command is currently in alpha and might change without notice. If this + command fails 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/scc/custom-modules/etd/list-effective b/gcloud/alpha/scc/custom-modules/etd/list-effective new file mode 100644 index 000000000..3f3416a7c --- /dev/null +++ b/gcloud/alpha/scc/custom-modules/etd/list-effective @@ -0,0 +1,98 @@ +NAME + gcloud alpha scc custom-modules etd list-effective - list the details of + Event Threat Detection custom modules with effective enablement states + +SYNOPSIS + gcloud alpha scc custom-modules etd list-effective + (--folder=FOLDER | --organization=ORGANIZATION | --project=PROJECT) + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List the details of resident and inherited Event Threat Detection + custom modules for the specified folder or project with their effective + enablement states. For an organization, this command lists only the custom + modules that are created at the organization level. Custom modules created + in child folders or projects are not included in the list. + +EXAMPLES + To list resident and inherited Event Threat Detection custom modules with + effective enablement states for organization 123, run: + + $ gcloud alpha scc custom-modules etd list-effective \ + --organization=organizations/123 + + To list resident and inherited effective Event Threat Detection custom + modules with effective enablement states for folder 456, run: + + $ gcloud alpha scc custom-modules etd list-effective \ + --folder=folders/456 + + To list resident and inherited effective Event Threat Detection custom + modules with effective enablement states for project 789, run: + + $ gcloud alpha scc custom-modules etd list-effective \ + --project=projects/789 + +REQUIRED FLAGS + Exactly one of these must be specified: + + --folder=FOLDER + Folder for listing the effective Event Threat Detection custom + modules created at the current folder level and inherited modules + from CRM ancestors. Formatted as folders/456 or just 456. + + --organization=ORGANIZATION + Organization for listing the effective Event Threat Detection custom + modules created at the organization level. Formatted as + organizations/123 or just 123. + + --project=PROJECT + ID or number of the project for listing the effective Event Threat + Detection custom modules for the current project level and inherited + modules from CRM ancestors. Formatted as projects/789 or just 789. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the securitycenter/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/security-command-center + +NOTES + This command is currently in alpha and might change without notice. If this + command fails 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/scc/custom-modules/etd/update b/gcloud/alpha/scc/custom-modules/etd/update index b39ebe1a0..be71f36f2 100644 --- a/gcloud/alpha/scc/custom-modules/etd/update +++ b/gcloud/alpha/scc/custom-modules/etd/update @@ -5,8 +5,9 @@ NAME SYNOPSIS gcloud alpha scc custom-modules etd update CUSTOM_MODULE [--custom-config-from-file=CUSTOM_CONFIG_FROM_FILE] - [--enablement-state=ENABLEMENT_STATE] [--organization=ORGANIZATION] - [--update-mask=UPDATE_MASK] [GCLOUD_WIDE_FLAG ...] + [--enablement-state=ENABLEMENT_STATE] [--update-mask=UPDATE_MASK] + [--folder=FOLDER | --organization=ORGANIZATION | --project=PROJECT] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Update an Event Threat Detection custom module. @@ -19,6 +20,20 @@ EXAMPLES --organization=organizations/123 --enablement-state="ENABLED" \ --custom-config-from-file=custom_config.json + To update an Event Threat Detection custom module with ID 123456 for folder + 456, run: + + $ gcloud alpha scc custom-modules etd update 123456 \ + --folder=folders/456 --enablement-state="ENABLED" \ + --custom-config-from-file=custom_config.json + + To update an Event Threat Detection custom module with ID 123456 for + project 789, run: + + $ gcloud alpha scc custom-modules etd update 123456 \ + --project=projects/789 --enablement-state="ENABLED" \ + --custom-config-from-file=custom_config.json + POSITIONAL ARGUMENTS CUSTOM_MODULE ID or the full resource name of the Event Threat Detection custom @@ -32,18 +47,29 @@ FLAGS --enablement-state=ENABLEMENT_STATE Sets the enablement state of the Event Threat Detection custom module. - Valid options are ENABLED and DISABLED. ENABLEMENT_STATE must be one - of: disabled, enabled, enablement-state-unspecified, inherited. - - --organization=ORGANIZATION - Organization where the Event Threat Detection custom module resides. - Formatted as organizations/123 or just 123. + Valid options are ENABLED, DISABLED, and INHERITED. ENABLEMENT_STATE + must be one of: disabled, enabled, enablement-state-unspecified, + inherited. --update-mask=UPDATE_MASK Optional: If left unspecified (default), an update mask is automatically created using the flags specified in the command and only those values are updated. + At most one of these can be specified: + + --folder=FOLDER + Folder where the Event Threat Detection custom module resides. + Formatted as folders/456 or just 456. + + --organization=ORGANIZATION + Organization where the Event Threat Detection custom module resides. + Formatted as organizations/123 or just 123. + + --project=PROJECT + ID or number of the project where the Event Threat Detection custom + module resides. Formatted as projects/789 or just 789. + 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/services/api-keys/create b/gcloud/alpha/services/api-keys/create index 8f5d40323..d0832af29 100644 --- a/gcloud/alpha/services/api-keys/create +++ b/gcloud/alpha/services/api-keys/create @@ -3,7 +3,7 @@ NAME SYNOPSIS gcloud alpha services api-keys create [--annotations=[KEY=VALUE,...]] - [--async] [--display-name=DISPLAY_NAME] + [--async] [--display-name=DISPLAY_NAME] [--key-id=KEY_ID] [--api-target=service=SERVICE,[...] --allowed-application=[sha1_fingerprint=SHA1_FINGERPRINT, package_name=PACKAGE_NAME,...] @@ -24,6 +24,10 @@ EXAMPLES $ gcloud alpha services api-keys create --annotations=foo=bar,abc=def + To create a key with user-specified key id: + + $ gcloud alpha services api-keys create --key-id="my-key-id" + To create a key with allowed referrers restriction: $ gcloud alpha services api-keys create \ @@ -76,6 +80,9 @@ FLAGS --display-name=DISPLAY_NAME Display name of the key to create. + --key-id=KEY_ID + User-specified ID of the key to create. + --api-target=service=SERVICE,[...] Repeatable. Specify service and optionally one or multiple specific methods. Both fields are case insensitive. If you need to specify @@ -112,7 +119,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud services api-keys create $ gcloud beta services api-keys create diff --git a/gcloud/alpha/services/api-keys/delete b/gcloud/alpha/services/api-keys/delete index b91150b4c..87333d4c2 100644 --- a/gcloud/alpha/services/api-keys/delete +++ b/gcloud/alpha/services/api-keys/delete @@ -8,6 +8,14 @@ SYNOPSIS DESCRIPTION (ALPHA) Delete an API key. +EXAMPLES + Delete an API Key : + + $ gcloud alpha services api-keys delete \ + projects/myproject/locations/global/keys/1234 + + $ gcloud alpha services api-keys delete 1234 + POSITIONAL ARGUMENTS Key resource - The name of the key to delete. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some @@ -57,7 +65,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud services api-keys delete $ gcloud beta services api-keys delete diff --git a/gcloud/alpha/services/api-keys/get-key-string b/gcloud/alpha/services/api-keys/get-key-string index ac63ec50c..1ba43fd33 100644 --- a/gcloud/alpha/services/api-keys/get-key-string +++ b/gcloud/alpha/services/api-keys/get-key-string @@ -6,6 +6,9 @@ SYNOPSIS gcloud alpha services api-keys get-key-string (KEY : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] +DESCRIPTION + (ALPHA) Get the key string of an API key + EXAMPLES To get the key string of API key 1234, run: @@ -61,7 +64,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud services api-keys get-key-string $ gcloud beta services api-keys get-key-string diff --git a/gcloud/alpha/services/api-keys/update b/gcloud/alpha/services/api-keys/update index 6904ef4fb..f68f1e94c 100644 --- a/gcloud/alpha/services/api-keys/update +++ b/gcloud/alpha/services/api-keys/update @@ -163,7 +163,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud services api-keys update $ gcloud beta services api-keys update diff --git a/gcloud/alpha/source/repos/clone b/gcloud/alpha/source/repos/clone index 8aa9bbe4b..8d90e2604 100644 --- a/gcloud/alpha/source/repos/clone +++ b/gcloud/alpha/source/repos/clone @@ -29,7 +29,7 @@ EXAMPLES $ cd DIRECTORY_NAME ... create/edit files and create one or more \ commits ... - $ git push origin master + $ git push origin main POSITIONAL ARGUMENTS REPOSITORY_NAME diff --git a/gcloud/alpha/storage/insights/dataset-configs/create b/gcloud/alpha/storage/insights/dataset-configs/create index c35d26e67..a70710359 100644 --- a/gcloud/alpha/storage/insights/dataset-configs/create +++ b/gcloud/alpha/storage/insights/dataset-configs/create @@ -1,6 +1,6 @@ NAME gcloud alpha storage insights dataset-configs create - create a new dataset - config for insights + config for Insights SYNOPSIS gcloud alpha storage insights dataset-configs create DATASET_CONFIG_NAME @@ -19,7 +19,7 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Create a new dataset config for insights. + (ALPHA) Create a new dataset config for Insights. EXAMPLES To create a dataset config with config name as "my-config" in location diff --git a/gcloud/alpha/storage/insights/dataset-configs/create-link b/gcloud/alpha/storage/insights/dataset-configs/create-link index 65ff0ff04..fdcb52934 100644 --- a/gcloud/alpha/storage/insights/dataset-configs/create-link +++ b/gcloud/alpha/storage/insights/dataset-configs/create-link @@ -7,7 +7,7 @@ SYNOPSIS (DATASET_CONFIG : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Create link to the customer BigQuery instance for insights dataset + (ALPHA) Create link to the customer BigQuery instance for Insights dataset config. EXAMPLES diff --git a/gcloud/alpha/storage/insights/dataset-configs/delete b/gcloud/alpha/storage/insights/dataset-configs/delete index e04f55bef..358e20650 100644 --- a/gcloud/alpha/storage/insights/dataset-configs/delete +++ b/gcloud/alpha/storage/insights/dataset-configs/delete @@ -1,6 +1,6 @@ NAME gcloud alpha storage insights dataset-configs delete - delete dataset - config for insights + config for Insights SYNOPSIS gcloud alpha storage insights dataset-configs delete @@ -8,7 +8,7 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Delete an insights dataset config. + (ALPHA) Delete an Insights dataset config. EXAMPLES To delete a dataset config with config name "my-config" in location diff --git a/gcloud/alpha/storage/insights/dataset-configs/describe b/gcloud/alpha/storage/insights/dataset-configs/describe index 098bf3e3c..4d5aaecd5 100644 --- a/gcloud/alpha/storage/insights/dataset-configs/describe +++ b/gcloud/alpha/storage/insights/dataset-configs/describe @@ -1,13 +1,13 @@ NAME gcloud alpha storage insights dataset-configs describe - describe dataset - config for insights + config for Insights SYNOPSIS gcloud alpha storage insights dataset-configs describe (DATASET_CONFIG : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Describe the insights dataset config. + (ALPHA) Describe the Insights dataset config. EXAMPLES To describe a dataset config with config name "my-config" in location diff --git a/gcloud/alpha/storage/insights/dataset-configs/help b/gcloud/alpha/storage/insights/dataset-configs/help index e7f6f7edd..8b1db2f3b 100644 --- a/gcloud/alpha/storage/insights/dataset-configs/help +++ b/gcloud/alpha/storage/insights/dataset-configs/help @@ -1,13 +1,13 @@ NAME gcloud alpha storage insights dataset-configs - manage Cloud Storage - insights dataset configurations + Insights dataset configurations SYNOPSIS gcloud alpha storage insights dataset-configs COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Manage Cloud Storage insights dataset configurations. + (ALPHA) Manage Cloud Storage Insights dataset configurations. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -18,26 +18,26 @@ COMMANDS COMMAND is one of the following: create - (ALPHA) Create a new dataset config for insights. + (ALPHA) Create a new dataset config for Insights. create-link (ALPHA) Create a link to a BigQuery instance. delete - (ALPHA) Delete dataset config for insights. + (ALPHA) Delete dataset config for Insights. delete-link (ALPHA) Delete a link to a BigQuery instance. describe - (ALPHA) Describe dataset config for insights. + (ALPHA) Describe dataset config for Insights. list - (ALPHA) List returns all the insights dataset configs for given + (ALPHA) List returns all the Insights dataset configs for given location. update - (ALPHA) Updates a dataset config for insights. + (ALPHA) Updates a dataset config for Insights. NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/storage/insights/dataset-configs/list b/gcloud/alpha/storage/insights/dataset-configs/list index 6cfd9998c..dedfb2ca3 100644 --- a/gcloud/alpha/storage/insights/dataset-configs/list +++ b/gcloud/alpha/storage/insights/dataset-configs/list @@ -1,6 +1,6 @@ NAME gcloud alpha storage insights dataset-configs list - list returns all the - insights dataset configs for given location + Insights dataset configs for given location SYNOPSIS gcloud alpha storage insights dataset-configs list [--location=LOCATION] @@ -8,7 +8,7 @@ SYNOPSIS [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) List Cloud storage insights dataset configs. + (ALPHA) List Cloud storage Insights dataset configs. EXAMPLES List all dataset configs in all locations: diff --git a/gcloud/alpha/storage/insights/dataset-configs/update b/gcloud/alpha/storage/insights/dataset-configs/update index a21cb1dd7..ca44bb6b4 100644 --- a/gcloud/alpha/storage/insights/dataset-configs/update +++ b/gcloud/alpha/storage/insights/dataset-configs/update @@ -1,6 +1,6 @@ NAME gcloud alpha storage insights dataset-configs update - updates a dataset - config for insights + config for Insights SYNOPSIS gcloud alpha storage insights dataset-configs update @@ -8,7 +8,7 @@ SYNOPSIS [--retention-period-days=RETENTION_DAYS] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Update a dataset config for insights. + (ALPHA) Update a dataset config for Insights. EXAMPLES To update the description for a dataset config "my-config" in location diff --git a/gcloud/alpha/storage/insights/help b/gcloud/alpha/storage/insights/help index fea20b83f..9e0489266 100644 --- a/gcloud/alpha/storage/insights/help +++ b/gcloud/alpha/storage/insights/help @@ -16,7 +16,7 @@ GROUPS GROUP is one of the following: dataset-configs - (ALPHA) Manage Cloud Storage insights dataset configurations. + (ALPHA) Manage Cloud Storage Insights dataset configurations. inventory-reports (ALPHA) Manage Cloud Storage inventory report configurations. diff --git a/gcloud/alpha/workstations/configs/create b/gcloud/alpha/workstations/configs/create index 5bcb1325c..f1f932009 100644 --- a/gcloud/alpha/workstations/configs/create +++ b/gcloud/alpha/workstations/configs/create @@ -11,8 +11,8 @@ SYNOPSIS [--container-env=[CONTAINER_ENV,...]] [--container-run-as-user=CONTAINER_RUN_AS_USER] [--container-working-dir=CONTAINER_WORKING_DIR] - [--disable-public-ip-addresses] [--enable-confidential-compute] - [--enable-nested-virtualization] + [--disable-public-ip-addresses] [--enable-audit-agent] + [--enable-confidential-compute] [--enable-nested-virtualization] [--idle-timeout=IDLE_TIMEOUT; default=7200] [--labels=[LABELS,...]] [--machine-type=MACHINE_TYPE; default="e2-standard-4"] [--network-tags=[NETWORK_TAGS,...]] @@ -139,6 +139,11 @@ FLAGS Default value is false. If set, instances will have no public IP address. + --enable-audit-agent + Whether to enable Linux auditd logging on the workstation. When + enabled, a service account must also be specified that has + logging.buckets.write permission on the project. + --enable-confidential-compute Default value is false. If set, instances will have confidential compute enabled. diff --git a/gcloud/alpha/workstations/configs/update b/gcloud/alpha/workstations/configs/update index 02b8b1df4..ae95273f3 100644 --- a/gcloud/alpha/workstations/configs/update +++ b/gcloud/alpha/workstations/configs/update @@ -11,11 +11,12 @@ SYNOPSIS [--container-env=[CONTAINER_ENV,...]] [--container-run-as-user=CONTAINER_RUN_AS_USER] [--container-working-dir=CONTAINER_WORKING_DIR] - [--disable-public-ip-addresses] [--enable-confidential-compute] - [--enable-nested-virtualization] [--idle-timeout=IDLE_TIMEOUT] - [--labels=[LABELS,...]] [--machine-type=MACHINE_TYPE] - [--network-tags=[NETWORK_TAGS,...]] [--pool-size=POOL_SIZE] - [--running-timeout=RUNNING_TIMEOUT] [--service-account=SERVICE_ACCOUNT] + [--disable-public-ip-addresses] [--enable-audit-agent] + [--enable-confidential-compute] [--enable-nested-virtualization] + [--idle-timeout=IDLE_TIMEOUT] [--labels=[LABELS,...]] + [--machine-type=MACHINE_TYPE] [--network-tags=[NETWORK_TAGS,...]] + [--pool-size=POOL_SIZE] [--running-timeout=RUNNING_TIMEOUT] + [--service-account=SERVICE_ACCOUNT] [--service-account-scopes=[SERVICE_ACCOUNT_SCOPES,...]] [--shielded-integrity-monitoring] [--shielded-secure-boot] [--shielded-vtpm] @@ -126,6 +127,11 @@ FLAGS Default value is false. If set, instances will have no public IP address. + --enable-audit-agent + Whether to enable Linux auditd logging on the workstation. When + enabled, a service account must also be specified that has + logging.buckets.write permission on the project. + --enable-confidential-compute Default value is false. If set, instances will have confidential compute enabled. diff --git a/gcloud/anthos/auth/login b/gcloud/anthos/auth/login index e57feb9de..5c023e891 100644 --- a/gcloud/anthos/auth/login +++ b/gcloud/anthos/auth/login @@ -4,8 +4,8 @@ NAME SYNOPSIS gcloud anthos auth login [--cluster=CLUSTER] [--dry-run] [--kubeconfig=KUBECONFIG] [--login-config=LOGIN_CONFIG] - [--login-config-cert=LOGIN_CONFIG_CERT] [--set-preferred-auth] - [--user=USER] [GCLOUD_WIDE_FLAG ...] + [--login-config-cert=LOGIN_CONFIG_CERT] [--server=SERVER] + [--set-preferred-auth] [--user=USER] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Authenticate clusters using the Anthos client. @@ -27,6 +27,16 @@ EXAMPLES $ gcloud anthos auth login --cluster=testcluster \ --login-config=kubectl-anthos-config.yaml --dry-run + To add credentials to default kubeconfig file using server side login: + + $ gcloud anthos auth login --cluster=testcluster \ + --server= + + To add credentials to custom kubeconfig file using server side login: + + $ gcloud anthos auth login --cluster=testcluster \ + --server= --kubeconfig=my.kubeconfig + FLAGS --cluster=CLUSTER Cluster to authenticate against. If no cluster is specified, the @@ -47,6 +57,9 @@ FLAGS Specifies the CA certificate file to be added to trusted pool for making HTTPS connections to a --login-config URL. + --server=SERVER + Specifies the URL of API server of the cluster to authenticate against. + --set-preferred-auth If set, forces update of preferred authentication for given cluster diff --git a/gcloud/artifacts/repositories/create b/gcloud/artifacts/repositories/create index 96893f5f4..594644d4a 100644 --- a/gcloud/artifacts/repositories/create +++ b/gcloud/artifacts/repositories/create @@ -141,7 +141,7 @@ OPTIONAL FLAGS --remote-apt-repo=REMOTE_APT_REPO (Apt only) Repository base for apt remote repository. REMOTE_APT_REPO - must be one of: [debian, ubuntu]. + must be one of: [debian, debian-snapshot, ubuntu]. --remote-apt-repo-path=REMOTE_APT_REPO_PATH (Apt only) Remaining URL path to apt remote repository. diff --git a/gcloud/backup-dr/help b/gcloud/backup-dr/help new file mode 100644 index 000000000..3d95b4b02 --- /dev/null +++ b/gcloud/backup-dr/help @@ -0,0 +1,33 @@ +NAME + gcloud backup-dr - manage Backup and DR resources + +SYNOPSIS + gcloud backup-dr GROUP [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Backup and DR resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + locations + Manage Backup and DR locations. + + management-servers + Manage Backup and DR management server. + + operations + Manage Backup and DR operations. + +NOTES + These variants are also available: + + $ gcloud alpha backup-dr + + $ gcloud beta backup-dr + diff --git a/gcloud/backup-dr/locations/help b/gcloud/backup-dr/locations/help new file mode 100644 index 000000000..56b9736fa --- /dev/null +++ b/gcloud/backup-dr/locations/help @@ -0,0 +1,27 @@ +NAME + gcloud backup-dr locations - manage Backup and DR locations + +SYNOPSIS + gcloud backup-dr locations COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Backup and DR locations. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + list + List available Backup and DR locations. + +NOTES + These variants are also available: + + $ gcloud alpha backup-dr locations + + $ gcloud beta backup-dr locations + diff --git a/gcloud/backup-dr/locations/list b/gcloud/backup-dr/locations/list new file mode 100644 index 000000000..7ba4be95c --- /dev/null +++ b/gcloud/backup-dr/locations/list @@ -0,0 +1,67 @@ +NAME + gcloud backup-dr locations list - list available Backup and DR locations + +SYNOPSIS + gcloud backup-dr locations list [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all locations where Backup and DR Service is available. + +EXAMPLES + To list all locations, run: + + $ gcloud backup-dr locations list + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the backupdr/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/backup-disaster-recovery + +NOTES + These variants are also available: + + $ gcloud alpha backup-dr locations list + + $ gcloud beta backup-dr locations list + diff --git a/gcloud/backup-dr/management-servers/create b/gcloud/backup-dr/management-servers/create new file mode 100644 index 000000000..adc121529 --- /dev/null +++ b/gcloud/backup-dr/management-servers/create @@ -0,0 +1,91 @@ +NAME + gcloud backup-dr management-servers create - create a new management server + in the project + +SYNOPSIS + gcloud backup-dr management-servers create + (MANAGEMENT_SERVER : --location=LOCATION) --network=NETWORK [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a new management server in the project. A management server is + required to access the management console. It can only be created in + locations where Backup and DR is available. Resources in other locations + can be backed up. + +EXAMPLES + To create a new management server sample-ms in project sample-project and + location us-central1 with network sample-network, run: + + $ gcloud backup-dr management-servers create sample-ms \ + --project=sample-project --location=us-central1 \ + --network=projects/sample-project/global/networks/sample-network + +POSITIONAL ARGUMENTS + Management Server resource - Name of the management server to be created. + Once the management server is deployed, this name can't be changed. The + name must be unique for a project and location. The arguments in this + group can be used to specify the attributes of 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 management_server 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. + + MANAGEMENT_SERVER + ID of the Management Server or fully qualified identifier for the + Management Server. + + To set the name attribute: + ▸ provide the argument management_server on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the Management Server. + + To set the location attribute: + ▸ provide the argument management_server on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --network=NETWORK + Name of an existing VPC network with private service access configured + in the format - projects//global/networks/. This VPC + network allows the management console to communicate with all + backup/recovery appliances and requires a minimum IP range of /23. This + value cannot be changed after you deploy the management server. If you + don't have private service access, configure one. [Learn more] + (https://cloud.google.com/vpc/docs/configure-private-services-access) + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. The default is True. Enabled by default, use --no-async to + disable. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +BRIEF + Creates a new management server + +NOTES + These variants are also available: + + $ gcloud alpha backup-dr management-servers create + + $ gcloud beta backup-dr management-servers create + diff --git a/gcloud/backup-dr/management-servers/delete b/gcloud/backup-dr/management-servers/delete new file mode 100644 index 000000000..e460f6937 --- /dev/null +++ b/gcloud/backup-dr/management-servers/delete @@ -0,0 +1,77 @@ +NAME + gcloud backup-dr management-servers delete - delete the specified + Management Server + +SYNOPSIS + gcloud backup-dr management-servers delete + (MANAGEMENT_SERVER : --location=LOCATION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete the specified Management Server. + +EXAMPLES + To delete a management server sample-ms in project sample-project and + location us-central1 , run: + + $ gcloud backup-dr management-servers delete sample-ms \ + --project=sample-project --location=us-central1 + +POSITIONAL ARGUMENTS + Management Server resource - Name of the management server to delete. + Before you delete, take a look at the prerequisites here + (https://cloud.google.com/backup-disaster-recovery/docs/configuration/decommission). + The arguments in this group can be used to specify the attributes of 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 management_server 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. + + MANAGEMENT_SERVER + ID of the Management Server or fully qualified identifier for the + Management Server. + + To set the name attribute: + ▸ provide the argument management_server on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the Management Server. + + To set the location attribute: + ▸ provide the argument management_server on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. The default is True. Enabled by default, use --no-async to + disable. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +BRIEF + Deletes a specific management server + +NOTES + These variants are also available: + + $ gcloud alpha backup-dr management-servers delete + + $ gcloud beta backup-dr management-servers delete + diff --git a/gcloud/backup-dr/management-servers/describe b/gcloud/backup-dr/management-servers/describe new file mode 100644 index 000000000..9362904fd --- /dev/null +++ b/gcloud/backup-dr/management-servers/describe @@ -0,0 +1,68 @@ +NAME + gcloud backup-dr management-servers describe - show details of the + management server + +SYNOPSIS + gcloud backup-dr management-servers describe + (MANAGEMENT_SERVER : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Show all configuration data associated with the specified management + server. + +EXAMPLES + To view details for management server 'MANAGEMENT_SERVER', run: + + $ gcloud backup-dr management-servers describe MANAGEMENT_SERVER + +POSITIONAL ARGUMENTS + ManagementServer resource - Name of the management server 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 management_server 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. + + MANAGEMENT_SERVER + ID of the managementServer or fully qualified identifier for the + managementServer. + + To set the management_server attribute: + ▸ provide the argument management_server on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location ID of the resource. + + To set the location attribute: + ▸ provide the argument management_server on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the backupdr/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/backup-disaster-recovery + +NOTES + These variants are also available: + + $ gcloud alpha backup-dr management-servers describe + + $ gcloud beta backup-dr management-servers describe + diff --git a/gcloud/backup-dr/management-servers/help b/gcloud/backup-dr/management-servers/help new file mode 100644 index 000000000..1fefc8722 --- /dev/null +++ b/gcloud/backup-dr/management-servers/help @@ -0,0 +1,37 @@ +NAME + gcloud backup-dr management-servers - manage Backup and DR management + server + +SYNOPSIS + gcloud backup-dr management-servers COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Backup and DR management server. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + Create a new management server in the project. + + delete + Delete the specified Management Server. + + describe + Show details of the management server. + + list + List management servers in the project. + +NOTES + These variants are also available: + + $ gcloud alpha backup-dr management-servers + + $ gcloud beta backup-dr management-servers + diff --git a/gcloud/backup-dr/management-servers/list b/gcloud/backup-dr/management-servers/list new file mode 100644 index 000000000..825348e10 --- /dev/null +++ b/gcloud/backup-dr/management-servers/list @@ -0,0 +1,92 @@ +NAME + gcloud backup-dr management-servers list - list management servers in the + project + +SYNOPSIS + gcloud backup-dr management-servers list [--location=LOCATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List management servers in the project. Currently, a project can have only + one management server. + +EXAMPLES + To list management servers for all locations, run: + + $ gcloud backup-dr management-servers list + + To list management servers in a location my-location, run: + + $ gcloud backup-dr management-servers list --location=my-location + +FLAGS + Location resource - Location for which management servers should be + listed. 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; + ◆ use default global location with a fully specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line; + ▸ use default global location . + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the backupdr/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/backup-disaster-recovery + +NOTES + These variants are also available: + + $ gcloud alpha backup-dr management-servers list + + $ gcloud beta backup-dr management-servers list + diff --git a/gcloud/backup-dr/operations/describe b/gcloud/backup-dr/operations/describe new file mode 100644 index 000000000..1a3c49b2c --- /dev/null +++ b/gcloud/backup-dr/operations/describe @@ -0,0 +1,65 @@ +NAME + gcloud backup-dr operations describe - describe an operation + +SYNOPSIS + gcloud backup-dr operations describe (OPERATION : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe a Backup and DR operation. + +EXAMPLES + To view details for operation 'OPERATION', run: + + $ gcloud backup-dr operations describe OPERATION + +POSITIONAL ARGUMENTS + Operation resource - Backup and DR operation to describe. The arguments in + this group can be used to specify the attributes of this resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. + + To set the project attribute: + ◆ provide the argument operation on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + OPERATION + ID of the operation or fully qualified identifier for the operation. + + To set the operation attribute: + ▸ provide the argument operation on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location ID of the resource. + + To set the location attribute: + ▸ provide the argument operation on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the backupdr/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/backup-disaster-recovery + +NOTES + These variants are also available: + + $ gcloud alpha backup-dr operations describe + + $ gcloud beta backup-dr operations describe + diff --git a/gcloud/backup-dr/operations/help b/gcloud/backup-dr/operations/help new file mode 100644 index 000000000..6886589b7 --- /dev/null +++ b/gcloud/backup-dr/operations/help @@ -0,0 +1,30 @@ +NAME + gcloud backup-dr operations - manage Backup and DR operations + +SYNOPSIS + gcloud backup-dr operations COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Backup and DR operations. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + Describe an operation. + + list + List all operations. + +NOTES + These variants are also available: + + $ gcloud alpha backup-dr operations + + $ gcloud beta backup-dr operations + diff --git a/gcloud/backup-dr/operations/list b/gcloud/backup-dr/operations/list new file mode 100644 index 000000000..e393ca68a --- /dev/null +++ b/gcloud/backup-dr/operations/list @@ -0,0 +1,90 @@ +NAME + gcloud backup-dr operations list - list all operations + +SYNOPSIS + gcloud backup-dr operations list --location=LOCATION [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all Backup and DR operations. + +EXAMPLES + To list all operations in a location my-location, run: + + $ gcloud backup-dr operations list --location=my-location + + To list all operations in all locations, run: + + $ gcloud backup-dr operations list --location=- + +REQUIRED FLAGS + Location resource - Location for which operations should be listed. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the backupdr/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/backup-disaster-recovery + +NOTES + These variants are also available: + + $ gcloud alpha backup-dr operations list + + $ gcloud beta backup-dr operations list + diff --git a/gcloud/beta/alloydb/instances/update b/gcloud/beta/alloydb/instances/update index f4abd4dd8..b811a6cdf 100644 --- a/gcloud/beta/alloydb/instances/update +++ b/gcloud/beta/alloydb/instances/update @@ -39,7 +39,8 @@ REQUIRED FLAGS OPTIONAL FLAGS --async Return immediately, without waiting for the operation in progress to - complete. + complete. The default is True. Enabled by default, use --no-async to + disable. --availability-type=AVAILABILITY_TYPE Specifies level of availability. AVAILABILITY_TYPE must be one of: diff --git a/gcloud/beta/anthos/auth/login b/gcloud/beta/anthos/auth/login index 4770c97c7..9cbacfd44 100644 --- a/gcloud/beta/anthos/auth/login +++ b/gcloud/beta/anthos/auth/login @@ -5,8 +5,8 @@ NAME SYNOPSIS gcloud beta anthos auth login [--cluster=CLUSTER] [--dry-run] [--kubeconfig=KUBECONFIG] [--login-config=LOGIN_CONFIG] - [--login-config-cert=LOGIN_CONFIG_CERT] [--set-preferred-auth] - [--user=USER] [GCLOUD_WIDE_FLAG ...] + [--login-config-cert=LOGIN_CONFIG_CERT] [--server=SERVER] + [--set-preferred-auth] [--user=USER] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Authenticate clusters using the Anthos client. @@ -28,6 +28,16 @@ EXAMPLES $ gcloud beta anthos auth login --cluster=testcluster \ --login-config=kubectl-anthos-config.yaml --dry-run + To add credentials to default kubeconfig file using server side login: + + $ gcloud beta anthos auth login --cluster=testcluster \ + --server= + + To add credentials to custom kubeconfig file using server side login: + + $ gcloud beta anthos auth login --cluster=testcluster \ + --server= --kubeconfig=my.kubeconfig + FLAGS --cluster=CLUSTER Cluster to authenticate against. If no cluster is specified, the @@ -48,6 +58,9 @@ FLAGS Specifies the CA certificate file to be added to trusted pool for making HTTPS connections to a --login-config URL. + --server=SERVER + Specifies the URL of API server of the cluster to authenticate against. + --set-preferred-auth If set, forces update of preferred authentication for given cluster diff --git a/gcloud/beta/app/help b/gcloud/beta/app/help index 912daa3f1..fe3269f96 100644 --- a/gcloud/beta/app/help +++ b/gcloud/beta/app/help @@ -68,6 +68,9 @@ GROUPS regions (BETA) View regional availability of App Engine runtime environments. + runtimes + (BETA) List runtimes available to Google App Engine. + services (BETA) View and manage your App Engine services. diff --git a/gcloud/beta/app/runtimes/help b/gcloud/beta/app/runtimes/help new file mode 100644 index 000000000..24536c6cc --- /dev/null +++ b/gcloud/beta/app/runtimes/help @@ -0,0 +1,23 @@ +NAME + gcloud beta app runtimes - list runtimes available to Google App Engine + +SYNOPSIS + gcloud beta app runtimes COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List runtimes available to Google App Engine. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + list + (BETA) List runtimes available. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/app/runtimes/list b/gcloud/beta/app/runtimes/list new file mode 100644 index 000000000..a10af44dd --- /dev/null +++ b/gcloud/beta/app/runtimes/list @@ -0,0 +1,65 @@ +NAME + gcloud beta app runtimes list - list runtimes available + +SYNOPSIS + gcloud beta app runtimes list --environment=ENVIRONMENT + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) This command lists all the runtimes available and their current + stages. + +EXAMPLES + To list all the runtimes for a given environment, run: + + $ gcloud beta app runtimes list --environment=standard + +REQUIRED FLAGS + --environment=ENVIRONMENT + Environment for the application. ENVIRONMENT must be (only one value is + supported): standard. + +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. + diff --git a/gcloud/beta/backup-dr/help b/gcloud/beta/backup-dr/help new file mode 100644 index 000000000..6ee9c223d --- /dev/null +++ b/gcloud/beta/backup-dr/help @@ -0,0 +1,34 @@ +NAME + gcloud beta backup-dr - manage Backup and DR resources + +SYNOPSIS + gcloud beta backup-dr GROUP [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Backup and DR resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + locations + (BETA) Manage Backup and DR locations. + + management-servers + (BETA) Manage Backup and DR management server. + + operations + (BETA) Manage Backup and DR operations. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud backup-dr + + $ gcloud alpha backup-dr + diff --git a/gcloud/beta/backup-dr/locations/help b/gcloud/beta/backup-dr/locations/help new file mode 100644 index 000000000..67037177f --- /dev/null +++ b/gcloud/beta/backup-dr/locations/help @@ -0,0 +1,28 @@ +NAME + gcloud beta backup-dr locations - manage Backup and DR locations + +SYNOPSIS + gcloud beta backup-dr locations COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Backup and DR locations. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + list + (BETA) List available Backup and DR locations. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud backup-dr locations + + $ gcloud alpha backup-dr locations + diff --git a/gcloud/beta/backup-dr/locations/list b/gcloud/beta/backup-dr/locations/list new file mode 100644 index 000000000..e0ee9c847 --- /dev/null +++ b/gcloud/beta/backup-dr/locations/list @@ -0,0 +1,69 @@ +NAME + gcloud beta backup-dr locations list - list available Backup and DR + locations + +SYNOPSIS + gcloud beta backup-dr locations list [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List all locations where Backup and DR Service is available. + +EXAMPLES + To list all locations, run: + + $ gcloud beta backup-dr locations list + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the backupdr/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/backup-disaster-recovery + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud backup-dr locations list + + $ gcloud alpha backup-dr locations list + diff --git a/gcloud/beta/backup-dr/management-servers/create b/gcloud/beta/backup-dr/management-servers/create new file mode 100644 index 000000000..a1f71bdc9 --- /dev/null +++ b/gcloud/beta/backup-dr/management-servers/create @@ -0,0 +1,92 @@ +NAME + gcloud beta backup-dr management-servers create - create a new management + server in the project + +SYNOPSIS + gcloud beta backup-dr management-servers create + (MANAGEMENT_SERVER : --location=LOCATION) --network=NETWORK [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create a new management server in the project. A management server + is required to access the management console. It can only be created in + locations where Backup and DR is available. Resources in other locations + can be backed up. + +EXAMPLES + To create a new management server sample-ms in project sample-project and + location us-central1 with network sample-network, run: + + $ gcloud beta backup-dr management-servers create sample-ms \ + --project=sample-project --location=us-central1 \ + --network=projects/sample-project/global/networks/sample-network + +POSITIONAL ARGUMENTS + Management Server resource - Name of the management server to be created. + Once the management server is deployed, this name can't be changed. The + name must be unique for a project and location. The arguments in this + group can be used to specify the attributes of 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 management_server 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. + + MANAGEMENT_SERVER + ID of the Management Server or fully qualified identifier for the + Management Server. + + To set the name attribute: + ▸ provide the argument management_server on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the Management Server. + + To set the location attribute: + ▸ provide the argument management_server on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --network=NETWORK + Name of an existing VPC network with private service access configured + in the format - projects//global/networks/. This VPC + network allows the management console to communicate with all + backup/recovery appliances and requires a minimum IP range of /23. This + value cannot be changed after you deploy the management server. If you + don't have private service access, configure one. [Learn more] + (https://cloud.google.com/vpc/docs/configure-private-services-access) + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. The default is True. Enabled by default, use --no-async to + disable. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +BRIEF + Creates a new management server + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud backup-dr management-servers create + + $ gcloud alpha backup-dr management-servers create + diff --git a/gcloud/beta/backup-dr/management-servers/delete b/gcloud/beta/backup-dr/management-servers/delete new file mode 100644 index 000000000..9e442acde --- /dev/null +++ b/gcloud/beta/backup-dr/management-servers/delete @@ -0,0 +1,78 @@ +NAME + gcloud beta backup-dr management-servers delete - delete the specified + Management Server + +SYNOPSIS + gcloud beta backup-dr management-servers delete + (MANAGEMENT_SERVER : --location=LOCATION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Delete the specified Management Server. + +EXAMPLES + To delete a management server sample-ms in project sample-project and + location us-central1 , run: + + $ gcloud beta backup-dr management-servers delete sample-ms \ + --project=sample-project --location=us-central1 + +POSITIONAL ARGUMENTS + Management Server resource - Name of the management server to delete. + Before you delete, take a look at the prerequisites here + (https://cloud.google.com/backup-disaster-recovery/docs/configuration/decommission). + The arguments in this group can be used to specify the attributes of 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 management_server 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. + + MANAGEMENT_SERVER + ID of the Management Server or fully qualified identifier for the + Management Server. + + To set the name attribute: + ▸ provide the argument management_server on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the Management Server. + + To set the location attribute: + ▸ provide the argument management_server on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. The default is True. Enabled by default, use --no-async to + disable. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +BRIEF + Deletes a specific management server + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud backup-dr management-servers delete + + $ gcloud alpha backup-dr management-servers delete + diff --git a/gcloud/beta/backup-dr/management-servers/describe b/gcloud/beta/backup-dr/management-servers/describe new file mode 100644 index 000000000..2b829bb39 --- /dev/null +++ b/gcloud/beta/backup-dr/management-servers/describe @@ -0,0 +1,69 @@ +NAME + gcloud beta backup-dr management-servers describe - show details of the + management server + +SYNOPSIS + gcloud beta backup-dr management-servers describe + (MANAGEMENT_SERVER : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Show all configuration data associated with the specified management + server. + +EXAMPLES + To view details for management server 'MANAGEMENT_SERVER', run: + + $ gcloud beta backup-dr management-servers describe MANAGEMENT_SERVER + +POSITIONAL ARGUMENTS + ManagementServer resource - Name of the management server 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 management_server 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. + + MANAGEMENT_SERVER + ID of the managementServer or fully qualified identifier for the + managementServer. + + To set the management_server attribute: + ▸ provide the argument management_server on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location ID of the resource. + + To set the location attribute: + ▸ provide the argument management_server on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the backupdr/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/backup-disaster-recovery + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud backup-dr management-servers describe + + $ gcloud alpha backup-dr management-servers describe + diff --git a/gcloud/beta/backup-dr/management-servers/help b/gcloud/beta/backup-dr/management-servers/help new file mode 100644 index 000000000..50bfc16a7 --- /dev/null +++ b/gcloud/beta/backup-dr/management-servers/help @@ -0,0 +1,38 @@ +NAME + gcloud beta backup-dr management-servers - manage Backup and DR management + server + +SYNOPSIS + gcloud beta backup-dr management-servers COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Backup and DR management server. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (BETA) Create a new management server in the project. + + delete + (BETA) Delete the specified Management Server. + + describe + (BETA) Show details of the management server. + + list + (BETA) List management servers in the project. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud backup-dr management-servers + + $ gcloud alpha backup-dr management-servers + diff --git a/gcloud/beta/backup-dr/management-servers/list b/gcloud/beta/backup-dr/management-servers/list new file mode 100644 index 000000000..8c7e93231 --- /dev/null +++ b/gcloud/beta/backup-dr/management-servers/list @@ -0,0 +1,94 @@ +NAME + gcloud beta backup-dr management-servers list - list management servers in + the project + +SYNOPSIS + gcloud beta backup-dr management-servers list [--location=LOCATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List management servers in the project. Currently, a project can + have only one management server. + +EXAMPLES + To list management servers for all locations, run: + + $ gcloud beta backup-dr management-servers list + + To list management servers in a location my-location, run: + + $ gcloud beta backup-dr management-servers list \ + --location=my-location + +FLAGS + Location resource - Location for which management servers should be + listed. 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; + ◆ use default global location with a fully specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line; + ▸ use default global location . + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the backupdr/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/backup-disaster-recovery + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud backup-dr management-servers list + + $ gcloud alpha backup-dr management-servers list + diff --git a/gcloud/beta/backup-dr/operations/describe b/gcloud/beta/backup-dr/operations/describe new file mode 100644 index 000000000..151b6877e --- /dev/null +++ b/gcloud/beta/backup-dr/operations/describe @@ -0,0 +1,66 @@ +NAME + gcloud beta backup-dr operations describe - describe an operation + +SYNOPSIS + gcloud beta backup-dr operations describe (OPERATION : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Describe a Backup and DR operation. + +EXAMPLES + To view details for operation 'OPERATION', run: + + $ gcloud beta backup-dr operations describe OPERATION + +POSITIONAL ARGUMENTS + Operation resource - Backup and DR operation to describe. The arguments in + this group can be used to specify the attributes of this resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. + + To set the project attribute: + ◆ provide the argument operation on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + OPERATION + ID of the operation or fully qualified identifier for the operation. + + To set the operation attribute: + ▸ provide the argument operation on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location ID of the resource. + + To set the location attribute: + ▸ provide the argument operation on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the backupdr/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/backup-disaster-recovery + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud backup-dr operations describe + + $ gcloud alpha backup-dr operations describe + diff --git a/gcloud/beta/backup-dr/operations/help b/gcloud/beta/backup-dr/operations/help new file mode 100644 index 000000000..54e174d61 --- /dev/null +++ b/gcloud/beta/backup-dr/operations/help @@ -0,0 +1,31 @@ +NAME + gcloud beta backup-dr operations - manage Backup and DR operations + +SYNOPSIS + gcloud beta backup-dr operations COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Backup and DR operations. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + (BETA) Describe an operation. + + list + (BETA) List all operations. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud backup-dr operations + + $ gcloud alpha backup-dr operations + diff --git a/gcloud/beta/backup-dr/operations/list b/gcloud/beta/backup-dr/operations/list new file mode 100644 index 000000000..2b9bd6575 --- /dev/null +++ b/gcloud/beta/backup-dr/operations/list @@ -0,0 +1,91 @@ +NAME + gcloud beta backup-dr operations list - list all operations + +SYNOPSIS + gcloud beta backup-dr operations list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List all Backup and DR operations. + +EXAMPLES + To list all operations in a location my-location, run: + + $ gcloud beta backup-dr operations list --location=my-location + + To list all operations in all locations, run: + + $ gcloud beta backup-dr operations list --location=- + +REQUIRED FLAGS + Location resource - Location for which operations should be listed. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the backupdr/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/backup-disaster-recovery + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud backup-dr operations list + + $ gcloud alpha backup-dr operations list + diff --git a/gcloud/beta/certificate-manager/trust-configs/create b/gcloud/beta/certificate-manager/trust-configs/create new file mode 100644 index 000000000..dbc9ebdc2 --- /dev/null +++ b/gcloud/beta/certificate-manager/trust-configs/create @@ -0,0 +1,107 @@ +NAME + gcloud beta certificate-manager trust-configs create - create TrustConfig + +SYNOPSIS + gcloud beta certificate-manager trust-configs create + (TRUST_CONFIG : --location=LOCATION) + --trust-store=[intermediate-cas=INTERMEDIATE-CAS], + [trust-anchors=TRUST-ANCHORS] [--async] [--description=DESCRIPTION] + [--labels=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create a TrustConfig. + +EXAMPLES + To create a TrustConfig from PEM certificate files, run: + + $ gcloud beta certificate-manager trust-configs create \ + my-trust-config --description="my description" \ + --labels=my-key1=my-value1,my-key2=my-value2 \ + --trust-store=trust-anchors=ta.pem,\ + intermediate-cas="ica1.pem;ica2.pem" + +POSITIONAL ARGUMENTS + TrustConfig resource - Name of the TrustConfig to create. The arguments in + this group can be used to specify the attributes of this resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. + + To set the project attribute: + ◆ provide the argument trust_config on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + TRUST_CONFIG + ID of the trustConfig or fully qualified identifier for the + trustConfig. + + To set the trust_config attribute: + ▸ provide the argument trust_config on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Certificate Manager location. + + To set the location attribute: + ▸ provide the argument trust_config on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ default value of location is [global]. + +REQUIRED FLAGS + --trust-store=[intermediate-cas=INTERMEDIATE-CAS],[trust-anchors=TRUST-ANCHORS] + Trust Store with the given trust anchor and intermediate CA PEM-encoded + certificates. Certificates should be provided in files. For multiple + file names, separate them by a semicolon (';') and quote them ('"'). + One file can contain multiple certificates. Intermediate CAs are + optional. + + Examples: + + Single files: --trust-store trust-anchors=ta.pem,intermediate-cas=ica.pem + + No intermediate CAs: --trust-store trust-anchors=ta.pem + + Multiple files: --trust-store trust-anchors="ta1.pem;ta2.pem",intermediate-cas="ica1.pem;ica2.pem" + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + Human-readable description of the resource. + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the certificatemanager/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/certificate-manager + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud certificate-manager trust-configs create + + $ gcloud alpha certificate-manager trust-configs create + diff --git a/gcloud/beta/certificate-manager/trust-configs/help b/gcloud/beta/certificate-manager/trust-configs/help index 7d75af222..35d56de4b 100644 --- a/gcloud/beta/certificate-manager/trust-configs/help +++ b/gcloud/beta/certificate-manager/trust-configs/help @@ -17,6 +17,9 @@ GCLOUD WIDE FLAGS COMMANDS COMMAND is one of the following: + create + (BETA) Create TrustConfig. + delete (BETA) Delete TrustConfig. diff --git a/gcloud/beta/composer/environments/run b/gcloud/beta/composer/environments/run index eb39ce75b..d2e23b068 100644 --- a/gcloud/beta/composer/environments/run +++ b/gcloud/beta/composer/environments/run @@ -83,15 +83,15 @@ POSITIONAL ARGUMENTS (listed with Airflow versions that support): backfill [**, 2.0.0), clear [**, 2.0.0), connections [**, 3.0.0), dag_state [**, 2.0.0), dags [1.10.14, 3.0.0), db [2.3.0, 3.0.0), delete_dag [1.10.1, 2.0.0), - kerberos [**, 3.0.0), kubernetes [2.1.4, 3.0.0), list_dag_runs [1.10.2, - 2.0.0), list_dags [**, 2.0.0), list_tasks [**, 2.0.0), next_execution - [1.10.2, 2.0.0), pause [**, 2.0.0), pool [**, 2.0.0), pools [1.10.14, - 3.0.0), render [**, 2.0.0), roles [2.0.0, 3.0.0), run [**, 2.0.0), - sync-perm [1.10.14, 3.0.0), sync_perm [1.10.2, 2.0.0), task_failed_deps - [**, 2.0.0), task_state [**, 2.0.0), tasks [1.10.14, 3.0.0), test [**, - 2.0.0), trigger_dag [**, 2.0.0), unpause [**, 2.0.0), upgrade_check - [1.10.15, 2.0.0), users [1.10.14, 3.0.0), variables [**, 3.0.0), - version [**, 3.0.0) (see + kerberos [**, 3.0.0), kubernetes [2.1.4, 3.0.0), list-import-errors + [**, 3.0.0), list_dag_runs [1.10.2, 2.0.0), list_dags [**, 2.0.0), + list_tasks [**, 2.0.0), next_execution [1.10.2, 2.0.0), pause [**, + 2.0.0), pool [**, 2.0.0), pools [1.10.14, 3.0.0), render [**, 2.0.0), + roles [2.0.0, 3.0.0), run [**, 2.0.0), sync-perm [1.10.14, 3.0.0), + sync_perm [1.10.2, 2.0.0), task_failed_deps [**, 2.0.0), task_state + [**, 2.0.0), tasks [1.10.14, 3.0.0), test [**, 2.0.0), trigger_dag [**, + 2.0.0), unpause [**, 2.0.0), upgrade_check [1.10.15, 2.0.0), users + [1.10.14, 3.0.0), variables [**, 3.0.0), version [**, 3.0.0) (see https://airflow.apache.org/docs/apache-airflow/stable/cli-and-env-variables-ref.html for more info). diff --git a/gcloud/beta/compute/addresses/describe b/gcloud/beta/compute/addresses/describe index d2d753ef0..c4f877e3d 100644 --- a/gcloud/beta/compute/addresses/describe +++ b/gcloud/beta/compute/addresses/describe @@ -1,6 +1,6 @@ NAME gcloud beta compute addresses describe - display detailed information about - an address + a reserved static address SYNOPSIS gcloud beta compute addresses describe NAME [--global | --region=REGION] @@ -8,7 +8,7 @@ SYNOPSIS DESCRIPTION (BETA) gcloud beta compute addresses describe displays all data associated - with an address in a project. + with a reserved static address in a project. EXAMPLES To get details about a global address, run: diff --git a/gcloud/beta/compute/addresses/help b/gcloud/beta/compute/addresses/help index f4b1da1fc..0fb342caa 100644 --- a/gcloud/beta/compute/addresses/help +++ b/gcloud/beta/compute/addresses/help @@ -29,7 +29,7 @@ COMMANDS (BETA) Release reserved IP addresses. describe - (BETA) Display detailed information about an address. + (BETA) Display detailed information about a reserved static address. list (BETA) List addresses. diff --git a/gcloud/beta/compute/connect-to-serial-port b/gcloud/beta/compute/connect-to-serial-port index 3889a8ae6..3043dad12 100644 --- a/gcloud/beta/compute/connect-to-serial-port +++ b/gcloud/beta/compute/connect-to-serial-port @@ -5,7 +5,8 @@ NAME SYNOPSIS gcloud beta compute connect-to-serial-port [USER@]INSTANCE [--dry-run] [--extra-args=KEY=VALUE,[KEY=VALUE,...]] [--force-key-file-overwrite] - [--port=PORT; default=1] [--ssh-key-file=SSH_KEY_FILE] [--zone=ZONE] + [--location=LOCATION] [--port=PORT; default=1] + [--ssh-key-file=SSH_KEY_FILE] [--zone=ZONE] [--ssh-key-expiration=SSH_KEY_EXPIRATION | --ssh-key-expire-after=SSH_KEY_EXPIRE_AFTER] [GCLOUD_WIDE_FLAG ...] @@ -59,6 +60,10 @@ FLAGS regenerated and will fail in both interactive and non-interactive environments. + --location=LOCATION + If provided, the region in which the serial console connection will + occur. Must be the region of the VM to connect to. + --port=PORT; default=1 The number of the requested serial port. Can be 1-4, default is 1. diff --git a/gcloud/beta/compute/firewall-rules/migrate b/gcloud/beta/compute/firewall-rules/migrate index 257089741..a1f3f6b8f 100644 --- a/gcloud/beta/compute/firewall-rules/migrate +++ b/gcloud/beta/compute/firewall-rules/migrate @@ -6,7 +6,8 @@ SYNOPSIS gcloud beta compute firewall-rules migrate --source-network=SOURCE_NETWORK (--bind-tags-to-instances | --export-tag-mapping | --target-firewall-policy=TARGET_FIREWALL_POLICY) - [--tag-mapping-file=TAG_MAPPING_FILE] [GCLOUD_WIDE_FLAG ...] + [--export-terraform-script] [--tag-mapping-file=TAG_MAPPING_FILE] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) gcloud beta compute firewall-rules migrate is used to create a new @@ -41,6 +42,10 @@ REQUIRED FLAGS result. OPTIONAL FLAGS + --export-terraform-script + If set, migration tool will output a terraform script to create a + Firewall Policy with migrated rules. + --tag-mapping-file=TAG_MAPPING_FILE Path to a JSON file with legacy tags and service accounts to secure tags mapping. diff --git a/gcloud/beta/compute/instance-templates/create b/gcloud/beta/compute/instance-templates/create index af6f2cada..1acde2f30 100644 --- a/gcloud/beta/compute/instance-templates/create +++ b/gcloud/beta/compute/instance-templates/create @@ -9,8 +9,7 @@ SYNOPSIS [--boot-disk-provisioned-iops=BOOT_DISK_PROVISIONED_IOPS] [--boot-disk-provisioned-throughput=BOOT_DISK_PROVISIONED_THROUGHPUT] [--boot-disk-size=BOOT_DISK_SIZE] [--boot-disk-type=BOOT_DISK_TYPE] - [--can-ip-forward] [--confidential-compute] - [--configure-disk=[PROPERTY=VALUE,...]] + [--can-ip-forward] [--configure-disk=[PROPERTY=VALUE,...]] [--create-disk=[PROPERTY=VALUE,...]] [--description=DESCRIPTION] [--disk=[auto-delete=AUTO-DELETE], [boot=BOOT],[device-name=DEVICE-NAME],[mode=MODE],[name=NAME]] @@ -56,6 +55,8 @@ SYNOPSIS : --boot-disk-kms-keyring=BOOT_DISK_KMS_KEYRING --boot-disk-kms-location=BOOT_DISK_KMS_LOCATION --boot-disk-kms-project=BOOT_DISK_KMS_PROJECT] + [--confidential-compute + | --confidential-compute-type=CONFIDENTIAL_COMPUTE_TYPE] [--custom-cpu=CUSTOM_CPU --custom-memory=CUSTOM_MEMORY : --custom-extensions --custom-vm-type=CUSTOM_VM_TYPE] [--image-project=IMAGE_PROJECT --image=IMAGE @@ -142,11 +143,6 @@ FLAGS If provided, allows the instances to send and receive packets with non-matching destination or source IP addresses. - --confidential-compute - The instance boots with Confidential Computing enabled. Confidential - Computing is based on Secure Encrypted Virtualization (SEV), an AMD - virtualization feature for running confidential instances. - --configure-disk=[PROPERTY=VALUE,...] This option has effect only when used with --source-instance. It allows you to override how the source-instance's disks are defined in the @@ -919,6 +915,29 @@ FLAGS ▸ provide the argument --boot-disk-kms-project on the command line; ▸ set the property core/project. + At most one of these can be specified: + + --confidential-compute + (DEPRECATED) The instance boots with Confidential Computing enabled. + Confidential Computing is based on Secure Encrypted Virtualization + (SEV), an AMD virtualization feature for running confidential + instances. + + The --confidential-compute flag will soon be deprecated. Please use + --confidential-compute-type=SEV instead + + --confidential-compute-type=CONFIDENTIAL_COMPUTE_TYPE + The instance boots with Confidential Computing enabled. Confidential + Computing can be based on Secure Encrypted Virtualization (SEV) or + Secure Encrypted Virtualization - Secure Nested Paging (SEV-SNP), + both of which are AMD virtualization features for running + confidential instances. CONFIDENTIAL_COMPUTE_TYPE must be one of: + + SEV + Secure Encrypted Virtualization + SEV_SNP + Secure Encrypted Virtualization - Secure Nested Paging + Custom machine type extensions. --custom-cpu=CUSTOM_CPU diff --git a/gcloud/beta/compute/instances/bulk/create b/gcloud/beta/compute/instances/bulk/create index c5bd1571e..5eca648de 100644 --- a/gcloud/beta/compute/instances/bulk/create +++ b/gcloud/beta/compute/instances/bulk/create @@ -12,8 +12,8 @@ SYNOPSIS [--boot-disk-provisioned-iops=BOOT_DISK_PROVISIONED_IOPS] [--boot-disk-provisioned-throughput=BOOT_DISK_PROVISIONED_THROUGHPUT] [--boot-disk-size=BOOT_DISK_SIZE] [--boot-disk-type=BOOT_DISK_TYPE] - [--can-ip-forward] [--confidential-compute] [--count=COUNT] - [--create-disk=[PROPERTY=VALUE,...]] [--description=DESCRIPTION] + [--can-ip-forward] [--count=COUNT] [--create-disk=[PROPERTY=VALUE,...]] + [--description=DESCRIPTION] [--disk=[boot=BOOT], [device-name=DEVICE-NAME],[name=NAME],[scope=SCOPE]] [--enable-display-device] [--[no-]enable-nested-virtualization] @@ -50,6 +50,8 @@ SYNOPSIS : --boot-disk-kms-keyring=BOOT_DISK_KMS_KEYRING --boot-disk-kms-location=BOOT_DISK_KMS_LOCATION --boot-disk-kms-project=BOOT_DISK_KMS_PROJECT] + [--confidential-compute + | --confidential-compute-type=CONFIDENTIAL_COMPUTE_TYPE] [--custom-cpu=CUSTOM_CPU --custom-memory=CUSTOM_MEMORY : --custom-extensions --custom-vm-type=CUSTOM_VM_TYPE] [--image-project=IMAGE_PROJECT --image=IMAGE @@ -185,11 +187,6 @@ OPTIONAL FLAGS If provided, allows the instances to send and receive packets with non-matching destination or source IP addresses. - --confidential-compute - The instance boots with Confidential Computing enabled. Confidential - Computing is based on Secure Encrypted Virtualization (SEV), an AMD - virtualization feature for running confidential instances. - --count=COUNT Number of Compute Engine virtual machines to create. If specified, and --predefined-names is specified, count must equal the amount of names @@ -832,6 +829,29 @@ OPTIONAL FLAGS ▸ provide the argument --boot-disk-kms-project on the command line; ▸ set the property core/project. + At most one of these can be specified: + + --confidential-compute + (DEPRECATED) The instance boots with Confidential Computing enabled. + Confidential Computing is based on Secure Encrypted Virtualization + (SEV), an AMD virtualization feature for running confidential + instances. + + The --confidential-compute flag will soon be deprecated. Please use + --confidential-compute-type=SEV instead + + --confidential-compute-type=CONFIDENTIAL_COMPUTE_TYPE + The instance boots with Confidential Computing enabled. Confidential + Computing can be based on Secure Encrypted Virtualization (SEV) or + Secure Encrypted Virtualization - Secure Nested Paging (SEV-SNP), + both of which are AMD virtualization features for running + confidential instances. CONFIDENTIAL_COMPUTE_TYPE must be one of: + + SEV + Secure Encrypted Virtualization + SEV_SNP + Secure Encrypted Virtualization - Secure Nested Paging + Custom machine type extensions. --custom-cpu=CUSTOM_CPU diff --git a/gcloud/beta/compute/instances/create b/gcloud/beta/compute/instances/create index 28a2621c2..65a11442f 100644 --- a/gcloud/beta/compute/instances/create +++ b/gcloud/beta/compute/instances/create @@ -10,9 +10,9 @@ SYNOPSIS [--boot-disk-provisioned-iops=BOOT_DISK_PROVISIONED_IOPS] [--boot-disk-provisioned-throughput=BOOT_DISK_PROVISIONED_THROUGHPUT] [--boot-disk-size=BOOT_DISK_SIZE] [--boot-disk-type=BOOT_DISK_TYPE] - [--can-ip-forward] [--confidential-compute] - [--create-disk=[PROPERTY=VALUE,...]] [--csek-key-file=FILE] - [--deletion-protection] [--description=DESCRIPTION] + [--can-ip-forward] [--create-disk=[PROPERTY=VALUE,...]] + [--csek-key-file=FILE] [--deletion-protection] + [--description=DESCRIPTION] [--disk=[auto-delete=AUTO-DELETE],[boot=BOOT],[device-name=DEVICE-NAME], [force-attach=FORCE-ATTACH],[mode=MODE],[name=NAME],[scope=SCOPE]] [--enable-display-device] [--[no-]enable-nested-virtualization] @@ -58,6 +58,8 @@ SYNOPSIS : --boot-disk-kms-keyring=BOOT_DISK_KMS_KEYRING --boot-disk-kms-location=BOOT_DISK_KMS_LOCATION --boot-disk-kms-project=BOOT_DISK_KMS_PROJECT] + [--confidential-compute + | --confidential-compute-type=CONFIDENTIAL_COMPUTE_TYPE] [--custom-cpu=CUSTOM_CPU --custom-memory=CUSTOM_MEMORY : --custom-extensions --custom-vm-type=CUSTOM_VM_TYPE] [--image-family-scope=IMAGE_FAMILY_SCOPE @@ -186,11 +188,6 @@ FLAGS If provided, allows the instances to send and receive packets with non-matching destination or source IP addresses. - --confidential-compute - The instance boots with Confidential Computing enabled. Confidential - Computing is based on Secure Encrypted Virtualization (SEV), an AMD - virtualization feature for running confidential instances. - --create-disk=[PROPERTY=VALUE,...] Creates and attaches persistent disks to the instances. @@ -996,6 +993,29 @@ FLAGS ▸ provide the argument --boot-disk-kms-project on the command line; ▸ set the property core/project. + At most one of these can be specified: + + --confidential-compute + (DEPRECATED) The instance boots with Confidential Computing enabled. + Confidential Computing is based on Secure Encrypted Virtualization + (SEV), an AMD virtualization feature for running confidential + instances. + + The --confidential-compute flag will soon be deprecated. Please use + --confidential-compute-type=SEV instead + + --confidential-compute-type=CONFIDENTIAL_COMPUTE_TYPE + The instance boots with Confidential Computing enabled. Confidential + Computing can be based on Secure Encrypted Virtualization (SEV) or + Secure Encrypted Virtualization - Secure Nested Paging (SEV-SNP), + both of which are AMD virtualization features for running + confidential instances. CONFIDENTIAL_COMPUTE_TYPE must be one of: + + SEV + Secure Encrypted Virtualization + SEV_SNP + Secure Encrypted Virtualization - Secure Nested Paging + Custom machine type extensions. --custom-cpu=CUSTOM_CPU diff --git a/gcloud/beta/compute/instances/create-with-container b/gcloud/beta/compute/instances/create-with-container index 29bd0015d..86ed2e0fb 100644 --- a/gcloud/beta/compute/instances/create-with-container +++ b/gcloud/beta/compute/instances/create-with-container @@ -10,8 +10,8 @@ SYNOPSIS [--boot-disk-provisioned-iops=BOOT_DISK_PROVISIONED_IOPS] [--boot-disk-provisioned-throughput=BOOT_DISK_PROVISIONED_THROUGHPUT] [--boot-disk-size=BOOT_DISK_SIZE] [--boot-disk-type=BOOT_DISK_TYPE] - [--can-ip-forward] [--confidential-compute] - [--container-arg=CONTAINER_ARG] [--container-command=CONTAINER_COMMAND] + [--can-ip-forward] [--container-arg=CONTAINER_ARG] + [--container-command=CONTAINER_COMMAND] [--container-env=[KEY=VALUE, ...,...]] [--container-env-file=CONTAINER_ENV_FILE] [--container-image=CONTAINER_IMAGE] @@ -50,6 +50,8 @@ SYNOPSIS [--threads-per-core=THREADS_PER_CORE] [--visible-core-count=VISIBLE_CORE_COUNT] [--zone=ZONE] [--address=ADDRESS | --no-address] + [--confidential-compute + | --confidential-compute-type=CONFIDENTIAL_COMPUTE_TYPE] [--custom-cpu=CUSTOM_CPU --custom-memory=CUSTOM_MEMORY : --custom-extensions --custom-vm-type=CUSTOM_VM_TYPE] [--image-project=IMAGE_PROJECT --image=IMAGE @@ -142,11 +144,6 @@ FLAGS If provided, allows the instances to send and receive packets with non-matching destination or source IP addresses. - --confidential-compute - The instance boots with Confidential Computing enabled. Confidential - Computing is based on Secure Encrypted Virtualization (SEV), an AMD - virtualization feature for running confidential instances. - --container-arg=CONTAINER_ARG Argument to append to container entrypoint or to override container CMD. Each argument must have a separate flag. Arguments are appended in @@ -780,6 +777,29 @@ FLAGS ▸ https://cloud.google.com/vpc/docs/configure-private-google-access ▸ https://cloud.google.com/nat/docs/using-nat + At most one of these can be specified: + + --confidential-compute + (DEPRECATED) The instance boots with Confidential Computing enabled. + Confidential Computing is based on Secure Encrypted Virtualization + (SEV), an AMD virtualization feature for running confidential + instances. + + The --confidential-compute flag will soon be deprecated. Please use + --confidential-compute-type=SEV instead + + --confidential-compute-type=CONFIDENTIAL_COMPUTE_TYPE + The instance boots with Confidential Computing enabled. Confidential + Computing can be based on Secure Encrypted Virtualization (SEV) or + Secure Encrypted Virtualization - Secure Nested Paging (SEV-SNP), + both of which are AMD virtualization features for running + confidential instances. CONFIDENTIAL_COMPUTE_TYPE must be one of: + + SEV + Secure Encrypted Virtualization + SEV_SNP + Secure Encrypted Virtualization - Secure Nested Paging + Custom machine type extensions. --custom-cpu=CUSTOM_CPU diff --git a/gcloud/beta/compute/instances/stop b/gcloud/beta/compute/instances/stop index 72141989a..e60d177f1 100644 --- a/gcloud/beta/compute/instances/stop +++ b/gcloud/beta/compute/instances/stop @@ -9,10 +9,22 @@ SYNOPSIS DESCRIPTION (BETA) gcloud beta compute instances stop is used to stop a Compute Engine virtual machine. Stopping a VM performs a clean shutdown, much like - invoking the shutdown functionality of a workstation or laptop. Stopping a - VM with a local SSD is not supported and will result in an API error unless - the --discard-local-ssd flag is passed. Stopping a VM which is already - stopped will return without errors. + invoking the shutdown functionality of a workstation or laptop. + + If a VM has any attached Local SSD disks, you must use the + --discard-local-ssd flag to indicate whether or not the Local SSD data + should be discarded. To stop the VM and preserve the Local SSD data when + you stop the VM by setting --discard-local-ssd=False. + + To stop the VM and discard the Local SSD data, specify + --discard-local-ssd=True. + + Preserving the Local SSD disk data incurs costs and is subject to + limitations. See + https://cloud.google.com/compute/docs/disks/local-ssd#stop_instance for + more information. + + Stopping a VM which is already stopped will return without errors. EXAMPLES To stop an instance named test-instance, run: diff --git a/gcloud/beta/compute/instances/suspend b/gcloud/beta/compute/instances/suspend index bea17bc71..83ac85029 100644 --- a/gcloud/beta/compute/instances/suspend +++ b/gcloud/beta/compute/instances/suspend @@ -17,8 +17,17 @@ DESCRIPTION Note: A suspended instance can be resumed by running the gcloud compute instances resume command. - Limitations: See this feature's restrictions at - https://cloud.google.com/compute/docs/instances/suspend-resume-instance#limitations + If a VM has any attached Local SSD disks, you can preserve the Local SSD + data when you suspend the VM by setting --discard-local-ssd=False. + Preserving the Local SSD disk data incurs costs and is subject to + limitations. + + Limitations: + + ▪ Limitations for suspending a VM: + https://cloud.google.com/compute/docs/instances/suspend-resume-instance#limitations + ▪ Limitations for preserving Local SSD data: + https://cloud.google.com/compute/docs/disks/local-ssd#stop_instance EXAMPLES To suspend an instance named test-instance, run: @@ -30,7 +39,7 @@ EXAMPLES $ gcloud beta compute instances suspend test-instance \ --discard-local-ssd=True - Using '--discard-local-ssd' without a value defaults to True. + Using --discard-local-ssd without a value defaults to True. POSITIONAL ARGUMENTS INSTANCE_NAMES [INSTANCE_NAMES ...] diff --git a/gcloud/beta/compute/network-endpoint-groups/create b/gcloud/beta/compute/network-endpoint-groups/create index b4fa7662f..ac80d2cd9 100644 --- a/gcloud/beta/compute/network-endpoint-groups/create +++ b/gcloud/beta/compute/network-endpoint-groups/create @@ -102,16 +102,16 @@ FLAGS Default port, network, and subnet are not effective for serverless endpoints. + private-service-connect + The network endpoint corresponds to a service outside the VPC, + accessed via Private Service Connect. + gce-vm-ip Endpoint must be the IP address of a VM's network interface in Compute Engine. Instance reference is required. The IP address is optional. If unspecified, the primary NIC address is used. A port must not be specified. - private-service-connect - The network endpoint corresponds to a service outside the VPC, - accessed via Private Service Connect. - NETWORK_ENDPOINT_TYPE must be one of: gce-vm-ip-port, internet-ip-port, internet-fqdn-port, non-gcp-private-ip-port, serverless, gce-vm-ip, private-service-connect. diff --git a/gcloud/beta/compute/routers/add-bgp-peer b/gcloud/beta/compute/routers/add-bgp-peer index 54e398c83..70a1cea8d 100644 --- a/gcloud/beta/compute/routers/add-bgp-peer +++ b/gcloud/beta/compute/routers/add-bgp-peer @@ -7,11 +7,14 @@ SYNOPSIS --peer-asn=PEER_ASN --peer-name=PEER_NAME [--advertised-route-priority=ADVERTISED_ROUTE_PRIORITY] [--advertisement-mode=MODE] [--async] - [--custom-learned-route-priority=PRIORITY] [--[no-]enable-ipv6] - [--[no-]enabled] [--instance=INSTANCE] [--instance-zone=INSTANCE_ZONE] + [--custom-learned-route-priority=PRIORITY] [--[no-]enable-ipv4] + [--[no-]enable-ipv6] [--[no-]enabled] [--instance=INSTANCE] + [--instance-zone=INSTANCE_ZONE] + [--ipv4-nexthop-address=IPV4_NEXTHOP_ADDRESS] [--ipv6-nexthop-address=IPV6_NEXTHOP_ADDRESS] [--md5-authentication-key=MD5_AUTHENTICATION_KEY] [--peer-ip-address=PEER_IP_ADDRESS] + [--peer-ipv4-nexthop-address=PEER_IPV4_NEXTHOP_ADDRESS] [--peer-ipv6-nexthop-address=PEER_IPV6_NEXTHOP_ADDRESS] [--region=REGION] [--set-advertisement-groups=[GROUP,...]] [--set-advertisement-ranges=[CIDR_RANGE=DESC,...]] @@ -66,6 +69,12 @@ OPTIONAL FLAGS Google-managed priority value of 100 is used. The routes with the lowest priority value win. + --[no-]enable-ipv4 + If IPv4 is enabled, the peer connection can be established with IPv4 + route exchange. If disabled, no IPv4 route exchange is allowed on any + active session. By default enabled for IPv4-based BGP sessions. Use + --enable-ipv4 to enable and --no-enable-ipv4 to disable. + --[no-]enable-ipv6 If IPv6 is enabled, the peer connection can be established with IPv6 route exchange. If disabled, no IPv6 route exchange is allowed on any @@ -105,22 +114,37 @@ OPTIONAL FLAGS Alternatively, the zone can be stored in the environment variable CLOUDSDK_COMPUTE_ZONE. + --ipv4-nexthop-address=IPV4_NEXTHOP_ADDRESS + If IPv4 route exchange is enabled for IPv6-based BGP, the IPv4 next hop + address of the Cloud Router interface for this BGP peer. Ignored + otherwise. Must be a Google owned link-local IPv4 address in the range + 169.254.0.0/16 and must belong to the same subnet as the interface + address of the peer router. + --ipv6-nexthop-address=IPV6_NEXTHOP_ADDRESS - The IPv6 next hop address of the Cloud Router interface for this BGP - peer. Must be a Google owned global unicast IPv6 address belonging to - the range 2600:2d00:0:2:0:0:0:0/64 or 2600:2d00:0:3:0:0:0:0/64 and must - belong to same subnet as the interface address of the peer router. + If IPv6 route exchange is enabled for IPv4-based BGP, the IPv6 next hop + address of the Cloud Router interface for this BGP peer. Ignored + otherwise. Must be a Google owned global unicast IPv6 address belonging + to the range 2600:2d00:0:2:0:0:0:0/64 or 2600:2d00:0:3:0:0:0:0/64 and + must belong to same subnet as the interface address of the peer router. --md5-authentication-key=MD5_AUTHENTICATION_KEY The MD5 authentication key for this BGP peer. Maximum length is 80 characters. Can contain only printable ASCII characters. --peer-ip-address=PEER_IP_ADDRESS - The link-local address of the peer router. Must be a link-local IPv4 - address belonging to the range 169.254.0.0/16. + The address of the peer router. Must be a link-local IPv4 address in + the the range 169.254.0.0/16 or an ULA IPv6 address in the range + fdff:1::/64. + + --peer-ipv4-nexthop-address=PEER_IPV4_NEXTHOP_ADDRESS + If IPv4 route exchange is enabled for IPv6-based BGP, the IPv4 next hop + address of the peer router. Ignored otherwise. Must be a Google owned + link-local IPv4 address in the range 169.254.0.0/16. --peer-ipv6-nexthop-address=PEER_IPV6_NEXTHOP_ADDRESS - The IPv6 next hop address of the peer router. Must be a Google owned + If IPv6 route exchange is enabled for IPv4-based BGP, the IPv6 next hop + address of the peer router. Ignored otherwise. Must be a Google owned global unicast IPv6 address belonging to the range 2600:2d00:0:2:0:0:0:0/64 or 2600:2d00:0:3:0:0:0:0/64. diff --git a/gcloud/beta/compute/routers/add-interface b/gcloud/beta/compute/routers/add-interface index e6e1c71b5..7eb5eeccd 100644 --- a/gcloud/beta/compute/routers/add-interface +++ b/gcloud/beta/compute/routers/add-interface @@ -9,9 +9,9 @@ SYNOPSIS --interconnect-attachment-region=INTERCONNECT_ATTACHMENT_REGION | --subnetwork=SUBNETWORK --subnetwork-region=SUBNETWORK_REGION | --vpn-tunnel=VPN_TUNNEL --vpn-tunnel-region=VPN_TUNNEL_REGION) - [--ip-address=IP_ADDRESS] [--mask-length=MASK_LENGTH] - [--redundant-interface=REDUNDANT_INTERFACE] [--region=REGION] - [GCLOUD_WIDE_FLAG ...] + [--ip-address=IP_ADDRESS] [--ip-version=IP_VERSION] + [--mask-length=MASK_LENGTH] [--redundant-interface=REDUNDANT_INTERFACE] + [--region=REGION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) gcloud beta compute routers add-interface is used to add an @@ -59,12 +59,22 @@ REQUIRED FLAGS OPTIONAL FLAGS --ip-address=IP_ADDRESS - The link local address of the router for this interface. + The link local (IPv4) or ULA (IPv6) address of the router for this + interface. + + --ip-version=IP_VERSION + IP version of the interface. Possible values are IPV4 and IPV6. + Defaults to IPV4. IP_VERSION must be one of: + + IPV4 + Interface with IPv4-based BGP. + IPV6 + Interface with IPv6-based BGP. --mask-length=MASK_LENGTH - The subnet mask for the link-local IP range of the interface. The - interface IP address and BGP peer IP address must be selected from the - subnet defined by this link-local range. + The subnet mask for the IP range of the interface. The interface IP + address and BGP peer IP address must be selected from the subnet + defined by this range. --redundant-interface=REDUNDANT_INTERFACE The interface that is redundant to the current interface. diff --git a/gcloud/beta/compute/routers/create b/gcloud/beta/compute/routers/create index 4189bf7cd..8b4ebf7e7 100644 --- a/gcloud/beta/compute/routers/create +++ b/gcloud/beta/compute/routers/create @@ -4,6 +4,7 @@ NAME SYNOPSIS gcloud beta compute routers create NAME --network=NETWORK [--advertisement-mode=MODE] [--asn=ASN] [--async] + [--bgp-identifier-range=BGP_IDENTIFIER_RANGE] [--description=DESCRIPTION] [--encrypted-interconnect-router] [--keepalive-interval=KEEPALIVE_INTERVAL] [--region=REGION] [--set-advertisement-groups=[GROUP,...]] @@ -40,6 +41,13 @@ OPTIONAL FLAGS Return immediately, without waiting for the operation in progress to complete. + --bgp-identifier-range=BGP_IDENTIFIER_RANGE + The range of valid BGP Identifiers for this Router. Must be a + link-local IPv4 range from 169.254.0.0/16, of size at least /30, even + if the BGP sessions are over IPv6. It must not overlap with any IPv4 + BGP session ranges. This is commonly called "router ID" by other + vendors. + --description=DESCRIPTION An optional description of this router. diff --git a/gcloud/beta/compute/routers/nats/create b/gcloud/beta/compute/routers/nats/create index 49b8f4989..8493da700 100644 --- a/gcloud/beta/compute/routers/nats/create +++ b/gcloud/beta/compute/routers/nats/create @@ -225,8 +225,8 @@ OPTIONAL FLAGS Used for private-to-private NAT translations. Allows communication between VPC Networks. PUBLIC - Used for private-to-public NAT translations. Allows VMs to - communicate with the Internet. + Used for private-to-public NAT translations. Allows VM instances to + communicate with the internet. --udp-idle-timeout=UDP_IDLE_TIMEOUT Timeout for UDP connections. See diff --git a/gcloud/beta/compute/routers/nats/rules/create b/gcloud/beta/compute/routers/nats/rules/create index b7ce71814..202ff0e22 100644 --- a/gcloud/beta/compute/routers/nats/rules/create +++ b/gcloud/beta/compute/routers/nats/rules/create @@ -78,16 +78,18 @@ OPTIONAL FLAGS CLOUDSDK_COMPUTE_REGION. --source-nat-active-ips=IP_ADDRESS,[IP_ADDRESS,...] - External IP Addresses to use for connections matching this rule. + External IP Addresses to use for connections matching this rule. This + flag is supported only for Public NAT and is required when creating a + Public NAT gateway. - These must be valid reserved external IPs in the same region. + These must be valid reserved external IP addresses in the same region. --source-nat-active-ranges=SUBNETWORK,[SUBNETWORK,...] Subnetworks from which addresses are used for connections matching this - rule. This is only supported for Private NAT, and is required when + rule. This flag is supported only for Private NAT and is required when creating a Private NAT gateway. - These must be Subnetwork resources in the same region, with purpose set + These must be subnetwork resources in the same region, with purpose set to PRIVATE_NAT. GCLOUD WIDE FLAGS diff --git a/gcloud/beta/compute/routers/nats/rules/update b/gcloud/beta/compute/routers/nats/rules/update index 4af796e9e..7adaf9e9b 100644 --- a/gcloud/beta/compute/routers/nats/rules/update +++ b/gcloud/beta/compute/routers/nats/rules/update @@ -82,22 +82,24 @@ OPTIONAL FLAGS CLOUDSDK_COMPUTE_REGION. --source-nat-active-ips=IP_ADDRESS,[IP_ADDRESS,...] - External IP Addresses to use for connections matching this rule. + External IP Addresses to use for connections matching this rule. This + flag is supported only for Public NAT and is required when creating a + Public NAT gateway. - These must be valid reserved external IPs in the same region. + These must be valid reserved external IP addresses in the same region. --source-nat-active-ranges=SUBNETWORK,[SUBNETWORK,...] Subnetworks from which addresses are used for connections matching this - rule. This is only supported for Private NAT, and is required when + rule. This flag is supported only for Private NAT and is required when creating a Private NAT gateway. - These must be Subnetwork resources in the same region, with purpose set + These must be subnetwork resources in the same region, with purpose set to PRIVATE_NAT. At most one of these can be specified: --clear-source-nat-drain-ips - Clear drained IPs from the Rule + Clear drained IPs from the rule --source-nat-drain-ips=IP_ADDRESS,[IP_ADDRESS,...] External IP Addresses to drain connections on. @@ -108,7 +110,7 @@ OPTIONAL FLAGS At most one of these can be specified: --clear-source-nat-drain-ranges - Clear drained ranges from the Rule + Clear drained ranges from the rule --source-nat-drain-ranges=SUBNETWORK,[SUBNETWORK,...] Subnetwork ranges to drain connections on. diff --git a/gcloud/beta/compute/routers/update b/gcloud/beta/compute/routers/update index 56a55588f..16a5b47f7 100644 --- a/gcloud/beta/compute/routers/update +++ b/gcloud/beta/compute/routers/update @@ -3,8 +3,9 @@ NAME SYNOPSIS gcloud beta compute routers update NAME [--advertisement-mode=MODE] - [--asn=ASN] [--async] [--keepalive-interval=KEEPALIVE_INTERVAL] - [--region=REGION] [--set-advertisement-groups=[GROUP,...]] + [--asn=ASN] [--async] [--bgp-identifier-range=BGP_IDENTIFIER_RANGE] + [--keepalive-interval=KEEPALIVE_INTERVAL] [--region=REGION] + [--set-advertisement-groups=[GROUP,...]] [--set-advertisement-ranges=[CIDR_RANGE=DESC,...]] [--add-advertisement-groups=[GROUP,...] | --add-advertisement-ranges=[CIDR_RANGE=DESC,...] @@ -38,6 +39,13 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --bgp-identifier-range=BGP_IDENTIFIER_RANGE + The range of valid BGP Identifiers for this Router. Must be a + link-local IPv4 range from 169.254.0.0/16, of size at least /30, even + if the BGP sessions are over IPv6. It must not overlap with any IPv4 + BGP session ranges. This is commonly called "router ID" by other + vendors. + --keepalive-interval=KEEPALIVE_INTERVAL The interval between BGP keepalive messages that are sent to the peer. If set, this value must be between 20 and 60 seconds. The default is 20 diff --git a/gcloud/beta/compute/routers/update-bgp-peer b/gcloud/beta/compute/routers/update-bgp-peer index 387f1a7c0..895cd84dd 100644 --- a/gcloud/beta/compute/routers/update-bgp-peer +++ b/gcloud/beta/compute/routers/update-bgp-peer @@ -6,11 +6,13 @@ SYNOPSIS gcloud beta compute routers update-bgp-peer NAME --peer-name=PEER_NAME [--advertised-route-priority=ADVERTISED_ROUTE_PRIORITY] [--advertisement-mode=MODE] [--async] [--clear-md5-authentication-key] - [--custom-learned-route-priority=PRIORITY] [--[no-]enable-ipv6] - [--[no-]enabled] [--interface=INTERFACE] [--ip-address=IP_ADDRESS] + [--custom-learned-route-priority=PRIORITY] [--[no-]enable-ipv4] + [--[no-]enable-ipv6] [--[no-]enabled] [--interface=INTERFACE] + [--ip-address=IP_ADDRESS] [--ipv4-nexthop-address=IPV4_NEXTHOP_ADDRESS] [--ipv6-nexthop-address=IPV6_NEXTHOP_ADDRESS] [--md5-authentication-key=MD5_AUTHENTICATION_KEY] [--peer-asn=PEER_ASN] [--peer-ip-address=PEER_IP_ADDRESS] + [--peer-ipv4-nexthop-address=PEER_IPV4_NEXTHOP_ADDRESS] [--peer-ipv6-nexthop-address=PEER_IPV6_NEXTHOP_ADDRESS] [--region=REGION] [--set-advertisement-groups=[GROUP,...]] [--set-advertisement-ranges=[CIDR_RANGE=DESC,...]] @@ -67,6 +69,12 @@ OPTIONAL FLAGS Google-managed priority value of 100 is used. The routes with the lowest priority value win. + --[no-]enable-ipv4 + If IPv4 is enabled, the peer connection can be established with IPv4 + route exchange. If disabled, no IPv4 route exchange is allowed on any + active session. Use --enable-ipv4 to enable and --no-enable-ipv4 to + disable. + --[no-]enable-ipv6 If IPv6 is enabled, the peer connection can be established with IPv6 route exchange. If disabled, no IPv6 route exchange is allowed on any @@ -83,16 +91,24 @@ OPTIONAL FLAGS The name of the interface for this BGP peer. --ip-address=IP_ADDRESS - The link-local address of the Cloud Router interface for this BGP peer. - Must be a link-local IPv4 address belonging to the range 169.254.0.0/16 - and must belong to same subnet as the interface address of the peer - router. + The address of the Cloud Router interface for this BGP peer. Must be a + link-local IPv4 address in the range 169.254.0.0/16 or an ULA IPv6 + address in the range fdff:1::/64. It must also be in the same subnet as + the interface address of the peer router. + + --ipv4-nexthop-address=IPV4_NEXTHOP_ADDRESS + If IPv4 route exchange is enabled for IPv6-based BGP, the IPv4 next hop + address of the Cloud Router interface for this BGP peer. Ignored + otherwise. Must be a Google owned link-local IPv4 address in the range + 169.254.0.0/16 and must belong to the same subnet as the interface + address of the peer router. --ipv6-nexthop-address=IPV6_NEXTHOP_ADDRESS - The IPv6 next hop address of the Cloud Router interface for this BGP - peer. Must be a Google owned global unicast IPv6 address belonging to - the range 2600:2d00:0:2:0:0:0:0/64 or 2600:2d00:0:3:0:0:0:0/64 and must - belong to same subnet as the interface address of the peer router. + If IPv6 route exchange is enabled for IPv4-based BGP, the IPv6 next hop + address of the Cloud Router interface for this BGP peer. Ignored + otherwise. Must be a Google owned global unicast IPv6 address belonging + to the range 2600:2d00:0:2:0:0:0:0/64 or 2600:2d00:0:3:0:0:0:0/64 and + must belong to same subnet as the interface address of the peer router. --md5-authentication-key=MD5_AUTHENTICATION_KEY The MD5 authentication key for this BGP peer. Maximum length is 80 @@ -104,11 +120,18 @@ OPTIONAL FLAGS https://tools.ietf.org/html/rfc6996, for example --asn=64512. --peer-ip-address=PEER_IP_ADDRESS - The link-local address of the peer router. Must be a link-local IPv4 - address belonging to the range 169.254.0.0/16. + The address of the peer router. Must be a link-local IPv4 address in + the the range 169.254.0.0/16 or an ULA IPv6 address in the range + fdff:1::/64. + + --peer-ipv4-nexthop-address=PEER_IPV4_NEXTHOP_ADDRESS + If IPv4 route exchange is enabled for IPv6-based BGP, the IPv4 next hop + address of the peer router. Ignored otherwise. Must be a Google owned + link-local IPv4 address in the range 169.254.0.0/16. --peer-ipv6-nexthop-address=PEER_IPV6_NEXTHOP_ADDRESS - The IPv6 next hop address of the peer router. Must be a Google owned + If IPv6 route exchange is enabled for IPv4-based BGP, the IPv6 next hop + address of the peer router. Ignored otherwise. Must be a Google owned global unicast IPv6 address belonging to the range 2600:2d00:0:2:0:0:0:0/64 or 2600:2d00:0:3:0:0:0:0/64. diff --git a/gcloud/beta/compute/routers/update-interface b/gcloud/beta/compute/routers/update-interface index 6686be9bb..708500d25 100644 --- a/gcloud/beta/compute/routers/update-interface +++ b/gcloud/beta/compute/routers/update-interface @@ -5,7 +5,7 @@ NAME SYNOPSIS gcloud beta compute routers update-interface NAME --interface-name=INTERFACE_NAME [--ip-address=IP_ADDRESS] - [--mask-length=MASK_LENGTH] [--region=REGION] + [--ip-version=IP_VERSION] [--mask-length=MASK_LENGTH] [--region=REGION] [--interconnect-attachment=INTERCONNECT_ATTACHMENT | --interconnect-attachment-region=INTERCONNECT_ATTACHMENT_REGION | --vpn-tunnel=VPN_TUNNEL | --vpn-tunnel-region=VPN_TUNNEL_REGION] @@ -25,12 +25,22 @@ REQUIRED FLAGS OPTIONAL FLAGS --ip-address=IP_ADDRESS - The link local address of the router for this interface. + The link local (IPv4) or ULA (IPv6) address of the router for this + interface. + + --ip-version=IP_VERSION + IP version of the interface. Possible values are IPV4 and IPV6. + Defaults to IPV4. IP_VERSION must be one of: + + IPV4 + Interface with IPv4-based BGP. + IPV6 + Interface with IPv6-based BGP. --mask-length=MASK_LENGTH - The subnet mask for the link-local IP range of the interface. The - interface IP address and BGP peer IP address must be selected from the - subnet defined by this link-local range. + The subnet mask for the IP range of the interface. The interface IP + address and BGP peer IP address must be selected from the subnet + defined by this range. --region=REGION Region of the router to update. If not specified, you might be prompted diff --git a/gcloud/beta/config/get b/gcloud/beta/config/get index 4b95de593..39bb3244f 100644 --- a/gcloud/beta/config/get +++ b/gcloud/beta/config/get @@ -1059,11 +1059,6 @@ AVAILABLE PROPERTIES resources. When a location value is required but not provided, the command will fall back to this value, if set. - region - Default region to use when working with Cloud NetApp Files regions. - When a --region flag is required but not provided, the command will - fall back to this value, if set. - notebooks location Default location to use when working with Notebook resources. When diff --git a/gcloud/beta/config/help b/gcloud/beta/config/help index 927b5fa44..ab2305e05 100644 --- a/gcloud/beta/config/help +++ b/gcloud/beta/config/help @@ -1091,11 +1091,6 @@ AVAILABLE PROPERTIES resources. When a location value is required but not provided, the command will fall back to this value, if set. - region - Default region to use when working with Cloud NetApp Files regions. - When a --region flag is required but not provided, the command will - fall back to this value, if set. - notebooks location Default location to use when working with Notebook resources. When diff --git a/gcloud/beta/config/list b/gcloud/beta/config/list index b5d79f94d..56511eb3e 100644 --- a/gcloud/beta/config/list +++ b/gcloud/beta/config/list @@ -1103,11 +1103,6 @@ AVAILABLE PROPERTIES resources. When a location value is required but not provided, the command will fall back to this value, if set. - region - Default region to use when working with Cloud NetApp Files regions. - When a --region flag is required but not provided, the command will - fall back to this value, if set. - notebooks location Default location to use when working with Notebook resources. When diff --git a/gcloud/beta/config/set b/gcloud/beta/config/set index 5bcab3658..669499788 100644 --- a/gcloud/beta/config/set +++ b/gcloud/beta/config/set @@ -1106,11 +1106,6 @@ AVAILABLE PROPERTIES resources. When a location value is required but not provided, the command will fall back to this value, if set. - region - Default region to use when working with Cloud NetApp Files regions. - When a --region flag is required but not provided, the command will - fall back to this value, if set. - notebooks location Default location to use when working with Notebook resources. When diff --git a/gcloud/beta/config/unset b/gcloud/beta/config/unset index 3a4e220a8..8ebf5aed2 100644 --- a/gcloud/beta/config/unset +++ b/gcloud/beta/config/unset @@ -1067,11 +1067,6 @@ AVAILABLE PROPERTIES resources. When a location value is required but not provided, the command will fall back to this value, if set. - region - Default region to use when working with Cloud NetApp Files regions. - When a --region flag is required but not provided, the command will - fall back to this value, if set. - notebooks location Default location to use when working with Notebook resources. When diff --git a/gcloud/beta/container/clusters/create b/gcloud/beta/container/clusters/create index fd7ae2744..872d09ea2 100644 --- a/gcloud/beta/container/clusters/create +++ b/gcloud/beta/container/clusters/create @@ -20,7 +20,6 @@ SYNOPSIS [--cluster-version=CLUSTER_VERSION] [--create-subnetwork=[KEY=VALUE,...]] [--database-encryption-key=DATABASE_ENCRYPTION_KEY] - [--dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE] [--default-max-pods-per-node=DEFAULT_MAX_PODS_PER_NODE] [--disable-default-snat] [--disable-pod-cidr-overprovision] [--disk-size=DISK_SIZE] [--disk-type=DISK_TYPE] [--enable-autorepair] @@ -75,9 +74,12 @@ SYNOPSIS [--additional-zones=ZONE,[ZONE,...] | --node-locations=ZONE,[ZONE,...]] [--cluster-dns=CLUSTER_DNS --cluster-dns-domain=CLUSTER_DNS_DOMAIN --cluster-dns-scope=CLUSTER_DNS_SCOPE] - [--binauthz-policy-bindings=[name=BINAUTHZ_POLICY,...] + [--binauthz-policy-bindings=[name=BINAUTHZ_POLICY] --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE | --enable-binauthz] + [--dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE + | --disable-dataplane-v2-flow-observability + | --enable-dataplane-v2-flow-observability] [--disable-dataplane-v2-metrics | --enable-dataplane-v2-metrics] [[--enable-autoprovisioning : --autoprovisioning-config-file=AUTOPROVISIONING_CONFIG_FILE @@ -353,35 +355,6 @@ FLAGS For more information, see https://cloud.google.com/kubernetes-engine/docs/how-to/encrypting-secrets. - --dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE - Select Advanced Datapath Observability mode for the cluster. Defaults - to DISABLED. - - Advanced Datapath Observability allows for a real-time view into - pod-to-pod traffic within your cluster. - - Examples: - - $ gcloud beta container clusters create \ - --dataplane-v2-observability-mode=DISABLED - - $ gcloud beta container clusters create \ - --dataplane-v2-observability-mode=INTERNAL_VPC_LB - - $ gcloud beta container clusters create \ - --dataplane-v2-observability-mode=EXTERNAL_LB - - DATAPLANE_V2_OBSERVABILITY_MODE must be one of: - - DISABLED - Disables Advanced Datapath Observability. - EXTERNAL_LB - Makes Advanced Datapath Observability available to the external - network. - INTERNAL_VPC_LB - Makes Advanced Datapath Observability available from the VPC - network. - --default-max-pods-per-node=DEFAULT_MAX_PODS_PER_NODE The default max number of pods per node for node pools in the cluster. @@ -1368,7 +1341,7 @@ FLAGS Flags for Binary Authorization: - --binauthz-policy-bindings=[name=BINAUTHZ_POLICY,...] + --binauthz-policy-bindings=[name=BINAUTHZ_POLICY] The relative resource name of the Binary Authorization policy to audit and/or enforce. GKE policies have the following format: projects/{project_number}/platforms/gke/policies/{policy_id}. @@ -1377,9 +1350,9 @@ FLAGS --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE Enable Binary Authorization for this cluster. - BINAUTHZ_EVALUATION_MODE must be one of: DISABLED, POLICY_BINDINGS, - POLICY_BINDINGS_AND_PROJECT_SINGLETON_POLICY_ENFORCE, - PROJECT_SINGLETON_POLICY_ENFORCE. + BINAUTHZ_EVALUATION_MODE must be one of: disabled, policy-bindings, + policy-bindings-and-project-singleton-policy-enforce, + project-singleton-policy-enforce. --enable-binauthz (DEPRECATED) Enable Binary Authorization for this cluster. @@ -1387,6 +1360,44 @@ FLAGS The --enable-binauthz flag is deprecated. Please use --binauthz-evaluation-mode instead. + At most one of these can be specified: + + --dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE + Select Advanced Datapath Observability mode for the cluster. Defaults + to DISABLED. + + Advanced Datapath Observability allows for a real-time view into + pod-to-pod traffic within your cluster. + + Examples: + + $ gcloud beta container clusters create \ + --dataplane-v2-observability-mode=DISABLED + + $ gcloud beta container clusters create \ + --dataplane-v2-observability-mode=INTERNAL_VPC_LB + + $ gcloud beta container clusters create \ + --dataplane-v2-observability-mode=EXTERNAL_LB + + DATAPLANE_V2_OBSERVABILITY_MODE must be one of: + + DISABLED + Disables Advanced Datapath Observability. + EXTERNAL_LB + Makes Advanced Datapath Observability available to the external + network. + INTERNAL_VPC_LB + Makes Advanced Datapath Observability available from the VPC + network. + + --disable-dataplane-v2-flow-observability + Disables Advanced Datapath Observability. + + --enable-dataplane-v2-flow-observability + Enables Advanced Datapath Observability which allows for a real-time + view into pod-to-pod traffic within your cluster. + At most one of these can be specified: --disable-dataplane-v2-metrics diff --git a/gcloud/beta/container/clusters/create-auto b/gcloud/beta/container/clusters/create-auto index 5fbad163a..0744511fc 100644 --- a/gcloud/beta/container/clusters/create-auto +++ b/gcloud/beta/container/clusters/create-auto @@ -12,7 +12,6 @@ SYNOPSIS [--cluster-version=CLUSTER_VERSION] [--create-subnetwork=[KEY=VALUE,...]] [--database-encryption-key=DATABASE_ENCRYPTION_KEY] - [--dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE] [--enable-backup-restore] [--enable-fleet] [--enable-google-cloud-access] [--enable-kubernetes-unstable-apis=API,[API,...]] @@ -25,7 +24,10 @@ SYNOPSIS [--subnetwork=SUBNETWORK] [--workload-policies=WORKLOAD_POLICIES] [--workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING] [--binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE - --binauthz-policy-bindings=[name=BINAUTHZ_POLICY,...]] + --binauthz-policy-bindings=[name=BINAUTHZ_POLICY]] + [--dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE + | --disable-dataplane-v2-flow-observability + | --enable-dataplane-v2-flow-observability] [--enable-master-authorized-networks --master-authorized-networks=NETWORK,[NETWORK,...]] [--enable-private-endpoint @@ -183,35 +185,6 @@ FLAGS For more information, see https://cloud.google.com/kubernetes-engine/docs/how-to/encrypting-secrets. - --dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE - Select Advanced Datapath Observability mode for the cluster. Defaults - to DISABLED. - - Advanced Datapath Observability allows for a real-time view into - pod-to-pod traffic within your cluster. - - Examples: - - $ gcloud beta container clusters create-auto \ - --dataplane-v2-observability-mode=DISABLED - - $ gcloud beta container clusters create-auto \ - --dataplane-v2-observability-mode=INTERNAL_VPC_LB - - $ gcloud beta container clusters create-auto \ - --dataplane-v2-observability-mode=EXTERNAL_LB - - DATAPLANE_V2_OBSERVABILITY_MODE must be one of: - - DISABLED - Disables Advanced Datapath Observability. - EXTERNAL_LB - Makes Advanced Datapath Observability available to the external - network. - INTERNAL_VPC_LB - Makes Advanced Datapath Observability available from the VPC - network. - --enable-backup-restore Enable the Backup for GKE add-on. This add-on is disabled by default. To learn more, see the Backup for GKE overview: @@ -403,15 +376,53 @@ FLAGS --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE Enable Binary Authorization for this cluster. - BINAUTHZ_EVALUATION_MODE must be one of: DISABLED, POLICY_BINDINGS, - POLICY_BINDINGS_AND_PROJECT_SINGLETON_POLICY_ENFORCE, - PROJECT_SINGLETON_POLICY_ENFORCE. + BINAUTHZ_EVALUATION_MODE must be one of: disabled, policy-bindings, + policy-bindings-and-project-singleton-policy-enforce, + project-singleton-policy-enforce. - --binauthz-policy-bindings=[name=BINAUTHZ_POLICY,...] + --binauthz-policy-bindings=[name=BINAUTHZ_POLICY] The relative resource name of the Binary Authorization policy to audit and/or enforce. GKE policies have the following format: projects/{project_number}/platforms/gke/policies/{policy_id}. + At most one of these can be specified: + + --dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE + Select Advanced Datapath Observability mode for the cluster. Defaults + to DISABLED. + + Advanced Datapath Observability allows for a real-time view into + pod-to-pod traffic within your cluster. + + Examples: + + $ gcloud beta container clusters create-auto \ + --dataplane-v2-observability-mode=DISABLED + + $ gcloud beta container clusters create-auto \ + --dataplane-v2-observability-mode=INTERNAL_VPC_LB + + $ gcloud beta container clusters create-auto \ + --dataplane-v2-observability-mode=EXTERNAL_LB + + DATAPLANE_V2_OBSERVABILITY_MODE must be one of: + + DISABLED + Disables Advanced Datapath Observability. + EXTERNAL_LB + Makes Advanced Datapath Observability available to the external + network. + INTERNAL_VPC_LB + Makes Advanced Datapath Observability available from the VPC + network. + + --disable-dataplane-v2-flow-observability + Disables Advanced Datapath Observability. + + --enable-dataplane-v2-flow-observability + Enables Advanced Datapath Observability which allows for a real-time + view into pod-to-pod traffic within your cluster. + Master Authorized Networks --enable-master-authorized-networks diff --git a/gcloud/beta/container/clusters/update b/gcloud/beta/container/clusters/update index 497dac425..e82679aa2 100644 --- a/gcloud/beta/container/clusters/update +++ b/gcloud/beta/container/clusters/update @@ -46,7 +46,7 @@ SYNOPSIS | --additional-zones=[ZONE,...] | --node-locations=ZONE,[ZONE,...] | --cluster-dns=CLUSTER_DNS --cluster-dns-domain=CLUSTER_DNS_DOMAIN --cluster-dns-scope=CLUSTER_DNS_SCOPE - | --binauthz-policy-bindings=[name=BINAUTHZ_POLICY,...] + | --binauthz-policy-bindings=[name=BINAUTHZ_POLICY] --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE | --enable-binauthz | --clear-maintenance-window | --remove-maintenance-exclusion=NAME @@ -62,6 +62,8 @@ SYNOPSIS --enable-resource-consumption-metering --resource-usage-bigquery-dataset=RESOURCE_USAGE_BIGQUERY_DATASET | --dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE + | --disable-dataplane-v2-flow-observability + | --enable-dataplane-v2-flow-observability --disable-dataplane-v2-metrics | --enable-dataplane-v2-metrics | [--enable-autoprovisioning : --autoprovisioning-config-file=AUTOPROVISIONING_CONFIG_FILE @@ -777,7 +779,7 @@ REQUIRED FLAGS Flags for Binary Authorization: - --binauthz-policy-bindings=[name=BINAUTHZ_POLICY,...] + --binauthz-policy-bindings=[name=BINAUTHZ_POLICY] The relative resource name of the Binary Authorization policy to audit and/or enforce. GKE policies have the following format: projects/{project_number}/platforms/gke/policies/{policy_id}. @@ -786,10 +788,10 @@ REQUIRED FLAGS --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE Enable Binary Authorization for this cluster. - BINAUTHZ_EVALUATION_MODE must be one of: DISABLED, - POLICY_BINDINGS, - POLICY_BINDINGS_AND_PROJECT_SINGLETON_POLICY_ENFORCE, - PROJECT_SINGLETON_POLICY_ENFORCE. + BINAUTHZ_EVALUATION_MODE must be one of: disabled, + policy-bindings, + policy-bindings-and-project-singleton-policy-enforce, + project-singleton-policy-enforce. --enable-binauthz (DEPRECATED) Enable Binary Authorization for this cluster. @@ -933,34 +935,43 @@ REQUIRED FLAGS $ gcloud beta container clusters update example-cluster \ --resource-usage-bigquery-dataset=example_bigquery_dataset_name - --dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE - Select Advanced Datapath Observability mode for the cluster. Defaults - to DISABLED. + At most one of these can be specified: - Advanced Datapath Observability allows for a real-time view into - pod-to-pod traffic within your cluster. + --dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE + Select Advanced Datapath Observability mode for the cluster. + Defaults to DISABLED. - Examples: + Advanced Datapath Observability allows for a real-time view into + pod-to-pod traffic within your cluster. - $ gcloud beta container clusters update \ - --dataplane-v2-observability-mode=DISABLED + Examples: - $ gcloud beta container clusters update \ - --dataplane-v2-observability-mode=INTERNAL_VPC_LB + $ gcloud beta container clusters update \ + --dataplane-v2-observability-mode=DISABLED - $ gcloud beta container clusters update \ - --dataplane-v2-observability-mode=EXTERNAL_LB + $ gcloud beta container clusters update \ + --dataplane-v2-observability-mode=INTERNAL_VPC_LB - DATAPLANE_V2_OBSERVABILITY_MODE must be one of: + $ gcloud beta container clusters update \ + --dataplane-v2-observability-mode=EXTERNAL_LB - DISABLED - Disables Advanced Datapath Observability. - EXTERNAL_LB - Makes Advanced Datapath Observability available to the external - network. - INTERNAL_VPC_LB - Makes Advanced Datapath Observability available from the VPC - network. + DATAPLANE_V2_OBSERVABILITY_MODE must be one of: + + DISABLED + Disables Advanced Datapath Observability. + EXTERNAL_LB + Makes Advanced Datapath Observability available to the external + network. + INTERNAL_VPC_LB + Makes Advanced Datapath Observability available from the VPC + network. + + --disable-dataplane-v2-flow-observability + Disables Advanced Datapath Observability. + + --enable-dataplane-v2-flow-observability + Enables Advanced Datapath Observability which allows for a + real-time view into pod-to-pod traffic within your cluster. At most one of these can be specified: diff --git a/gcloud/beta/container/fleet/create b/gcloud/beta/container/fleet/create index 397036776..89886232a 100644 --- a/gcloud/beta/container/fleet/create +++ b/gcloud/beta/container/fleet/create @@ -4,7 +4,9 @@ NAME SYNOPSIS gcloud beta container fleet create [--async] [--display-name=DISPLAY_NAME] [--labels=[KEY=VALUE,...]] - [--security-posture=SECURITY_POSTURE + [--binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE + --binauthz-policy-bindings=[name=BINAUTHZ_POLICY,...] + --security-posture=SECURITY_POSTURE --workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING] [GCLOUD_WIDE_FLAG ...] @@ -41,6 +43,22 @@ FLAGS Default cluster configurations to apply across the fleet. + Binary Authorization config. + + --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE + Configure binary authorization mode for clusters to onboard the + fleet, + + $ gcloud beta container fleet create \ + --binauthz-evaluation-mode=POLICY_BINDINGS + + BINAUTHZ_EVALUATION_MODE must be one of: DISABLED, POLICY_BINDINGS. + + --binauthz-policy-bindings=[name=BINAUTHZ_POLICY,...] + The relative resource name of the Binary Authorization policy to + audit and/or enforce. GKE policies have the following format: + projects/{project_number}/platforms/gke/policies/{policy_id}. + Security posture config. --security-posture=SECURITY_POSTURE diff --git a/gcloud/beta/container/fleet/dataplane-v2-encryption/describe b/gcloud/beta/container/fleet/dataplane-v2-encryption/describe new file mode 100644 index 000000000..a0545c1ba --- /dev/null +++ b/gcloud/beta/container/fleet/dataplane-v2-encryption/describe @@ -0,0 +1,33 @@ +NAME + gcloud beta container fleet dataplane-v2-encryption describe - describes + the status of the Dataplane V2 Encryption Feature resource + +SYNOPSIS + gcloud beta container fleet dataplane-v2-encryption describe + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) This command gets the detailed status of the Dataplane V2 Encryption + Feature in a fleet. + +EXAMPLES + To describe the Dataplane V2 Encryption Feature, run: + + $ gcloud beta container fleet dataplane-v2-encryption describe + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --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 container fleet dataplane-v2-encryption describe + + $ gcloud alpha container fleet dataplane-v2-encryption describe + diff --git a/gcloud/beta/container/fleet/dataplane-v2-encryption/disable b/gcloud/beta/container/fleet/dataplane-v2-encryption/disable new file mode 100644 index 000000000..efb6ae53f --- /dev/null +++ b/gcloud/beta/container/fleet/dataplane-v2-encryption/disable @@ -0,0 +1,38 @@ +NAME + gcloud beta container fleet dataplane-v2-encryption disable - disables the + Dataplane V2 Encryption Feature + +SYNOPSIS + gcloud beta container fleet dataplane-v2-encryption disable [--force] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) This command disables the Dataplane V2 Encryption Feature in a + fleet. + +EXAMPLES + To disable the Dataplane V2 Encryption Feature, run: + + $ gcloud beta container fleet dataplane-v2-encryption disable + +FLAGS + --force + Disable this feature, even if it is currently in use. Force disablement + may result in unexpected behavior. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --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 container fleet dataplane-v2-encryption disable + + $ gcloud alpha container fleet dataplane-v2-encryption disable + diff --git a/gcloud/beta/container/fleet/dataplane-v2-encryption/enable b/gcloud/beta/container/fleet/dataplane-v2-encryption/enable new file mode 100644 index 000000000..08ebbf68f --- /dev/null +++ b/gcloud/beta/container/fleet/dataplane-v2-encryption/enable @@ -0,0 +1,32 @@ +NAME + gcloud beta container fleet dataplane-v2-encryption enable - enables the + Dataplane V2 Encryption Feature + +SYNOPSIS + gcloud beta container fleet dataplane-v2-encryption enable + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) This command enables the Dataplane V2 Encryption Feature in a fleet. + +EXAMPLES + To enable the Dataplane V2 Encryption Feature, run: + + $ gcloud beta container fleet dataplane-v2-encryption enable + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --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 container fleet dataplane-v2-encryption enable + + $ gcloud alpha container fleet dataplane-v2-encryption enable + diff --git a/gcloud/beta/container/fleet/dataplane-v2-encryption/help b/gcloud/beta/container/fleet/dataplane-v2-encryption/help new file mode 100644 index 000000000..9d28bbf7e --- /dev/null +++ b/gcloud/beta/container/fleet/dataplane-v2-encryption/help @@ -0,0 +1,37 @@ +NAME + gcloud beta container fleet dataplane-v2-encryption - manage Dataplane V2 + Encryption Feature + +SYNOPSIS + gcloud beta container fleet dataplane-v2-encryption COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Dataplane V2 Encryption Feature. + +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) Describes the status of the Dataplane V2 Encryption Feature + resource. + + disable + (BETA) Disables the Dataplane V2 Encryption Feature. + + enable + (BETA) Enables the Dataplane V2 Encryption Feature. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container fleet dataplane-v2-encryption + + $ gcloud alpha container fleet dataplane-v2-encryption + diff --git a/gcloud/beta/container/fleet/help b/gcloud/beta/container/fleet/help index 4580c63db..9e1b08915 100644 --- a/gcloud/beta/container/fleet/help +++ b/gcloud/beta/container/fleet/help @@ -51,6 +51,9 @@ GROUPS config-management (BETA) Manage Config Management Feature. + dataplane-v2-encryption + (BETA) Manage Dataplane V2 Encryption Feature. + features (BETA) Manage Hub Feature resources. diff --git a/gcloud/beta/container/fleet/policycontroller/deployment/remove b/gcloud/beta/container/fleet/policycontroller/deployment/remove index 3f54c8160..026ba709d 100644 --- a/gcloud/beta/container/fleet/policycontroller/deployment/remove +++ b/gcloud/beta/container/fleet/policycontroller/deployment/remove @@ -64,6 +64,11 @@ EXAMPLES $ gcloud beta container fleet policycontroller deployment remove \ audit cpu-request + To remove the anti-affinity configuration: + + $ gcloud beta container fleet policycontroller deployment remove \ + admission pod-affinity + POSITIONAL ARGUMENTS DEPLOYMENT The PolicyController deployment component (i.e, "admission", "audit" or diff --git a/gcloud/beta/container/fleet/policycontroller/deployment/set b/gcloud/beta/container/fleet/policycontroller/deployment/set index 9761bad74..0e3bfb928 100644 --- a/gcloud/beta/container/fleet/policycontroller/deployment/set +++ b/gcloud/beta/container/fleet/policycontroller/deployment/set @@ -72,6 +72,12 @@ EXAMPLES $ gcloud beta container fleet policycontroller deployment set \ audit cpu-request 250m + To set anti-affinity to achieve high availability on the mutation + deployment: + + $ gcloud beta container fleet policycontroller deployment set \ + mutation pod-affinity anti + POSITIONAL ARGUMENTS DEPLOYMENT The PolicyController deployment component (e.g. "admission", "audit" or diff --git a/gcloud/beta/container/fleet/update b/gcloud/beta/container/fleet/update index 1104307da..4babbbc16 100644 --- a/gcloud/beta/container/fleet/update +++ b/gcloud/beta/container/fleet/update @@ -4,7 +4,9 @@ NAME SYNOPSIS gcloud beta container fleet update [--async] [--display-name=DISPLAY_NAME] [--update-labels=[KEY=VALUE,...]] - [--security-posture=SECURITY_POSTURE + [--binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE + --binauthz-policy-bindings=[name=BINAUTHZ_POLICY,...] + --security-posture=SECURITY_POSTURE --workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] @@ -42,6 +44,22 @@ FLAGS Default cluster configurations to apply across the fleet. + Binary Authorization config. + + --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE + Configure binary authorization mode for clusters to onboard the + fleet, + + $ gcloud beta container fleet update \ + --binauthz-evaluation-mode=POLICY_BINDINGS + + BINAUTHZ_EVALUATION_MODE must be one of: DISABLED, POLICY_BINDINGS. + + --binauthz-policy-bindings=[name=BINAUTHZ_POLICY,...] + The relative resource name of the Binary Authorization policy to + audit and/or enforce. GKE policies have the following format: + projects/{project_number}/platforms/gke/policies/{policy_id}. + Security posture config. --security-posture=SECURITY_POSTURE diff --git a/gcloud/beta/container/hub/create b/gcloud/beta/container/hub/create index 9fb79c3c0..ad5533279 100644 --- a/gcloud/beta/container/hub/create +++ b/gcloud/beta/container/hub/create @@ -4,7 +4,9 @@ NAME SYNOPSIS gcloud beta container hub create [--async] [--display-name=DISPLAY_NAME] [--labels=[KEY=VALUE,...]] - [--security-posture=SECURITY_POSTURE + [--binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE + --binauthz-policy-bindings=[name=BINAUTHZ_POLICY,...] + --security-posture=SECURITY_POSTURE --workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING] [GCLOUD_WIDE_FLAG ...] @@ -41,6 +43,22 @@ FLAGS Default cluster configurations to apply across the fleet. + Binary Authorization config. + + --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE + Configure binary authorization mode for clusters to onboard the + fleet, + + $ gcloud beta container hub create \ + --binauthz-evaluation-mode=POLICY_BINDINGS + + BINAUTHZ_EVALUATION_MODE must be one of: DISABLED, POLICY_BINDINGS. + + --binauthz-policy-bindings=[name=BINAUTHZ_POLICY,...] + The relative resource name of the Binary Authorization policy to + audit and/or enforce. GKE policies have the following format: + projects/{project_number}/platforms/gke/policies/{policy_id}. + Security posture config. --security-posture=SECURITY_POSTURE diff --git a/gcloud/beta/container/hub/dataplane-v2-encryption/describe b/gcloud/beta/container/hub/dataplane-v2-encryption/describe new file mode 100644 index 000000000..3c966f0aa --- /dev/null +++ b/gcloud/beta/container/hub/dataplane-v2-encryption/describe @@ -0,0 +1,33 @@ +NAME + gcloud beta container hub dataplane-v2-encryption describe - describes the + status of the Dataplane V2 Encryption Feature resource + +SYNOPSIS + gcloud beta container hub dataplane-v2-encryption describe + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) This command gets the detailed status of the Dataplane V2 Encryption + Feature in a fleet. + +EXAMPLES + To describe the Dataplane V2 Encryption Feature, run: + + $ gcloud beta container hub dataplane-v2-encryption describe + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --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 container hub dataplane-v2-encryption describe + + $ gcloud alpha container hub dataplane-v2-encryption describe + diff --git a/gcloud/beta/container/hub/dataplane-v2-encryption/disable b/gcloud/beta/container/hub/dataplane-v2-encryption/disable new file mode 100644 index 000000000..31a13fa7f --- /dev/null +++ b/gcloud/beta/container/hub/dataplane-v2-encryption/disable @@ -0,0 +1,38 @@ +NAME + gcloud beta container hub dataplane-v2-encryption disable - disables the + Dataplane V2 Encryption Feature + +SYNOPSIS + gcloud beta container hub dataplane-v2-encryption disable [--force] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) This command disables the Dataplane V2 Encryption Feature in a + fleet. + +EXAMPLES + To disable the Dataplane V2 Encryption Feature, run: + + $ gcloud beta container hub dataplane-v2-encryption disable + +FLAGS + --force + Disable this feature, even if it is currently in use. Force disablement + may result in unexpected behavior. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --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 container hub dataplane-v2-encryption disable + + $ gcloud alpha container hub dataplane-v2-encryption disable + diff --git a/gcloud/beta/container/hub/dataplane-v2-encryption/enable b/gcloud/beta/container/hub/dataplane-v2-encryption/enable new file mode 100644 index 000000000..e33a8bd3e --- /dev/null +++ b/gcloud/beta/container/hub/dataplane-v2-encryption/enable @@ -0,0 +1,32 @@ +NAME + gcloud beta container hub dataplane-v2-encryption enable - enables the + Dataplane V2 Encryption Feature + +SYNOPSIS + gcloud beta container hub dataplane-v2-encryption enable + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) This command enables the Dataplane V2 Encryption Feature in a fleet. + +EXAMPLES + To enable the Dataplane V2 Encryption Feature, run: + + $ gcloud beta container hub dataplane-v2-encryption enable + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --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 container hub dataplane-v2-encryption enable + + $ gcloud alpha container hub dataplane-v2-encryption enable + diff --git a/gcloud/beta/container/hub/dataplane-v2-encryption/help b/gcloud/beta/container/hub/dataplane-v2-encryption/help new file mode 100644 index 000000000..191b189d9 --- /dev/null +++ b/gcloud/beta/container/hub/dataplane-v2-encryption/help @@ -0,0 +1,37 @@ +NAME + gcloud beta container hub dataplane-v2-encryption - manage Dataplane V2 + Encryption Feature + +SYNOPSIS + gcloud beta container hub dataplane-v2-encryption COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Dataplane V2 Encryption Feature. + +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) Describes the status of the Dataplane V2 Encryption Feature + resource. + + disable + (BETA) Disables the Dataplane V2 Encryption Feature. + + enable + (BETA) Enables the Dataplane V2 Encryption Feature. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container hub dataplane-v2-encryption + + $ gcloud alpha container hub dataplane-v2-encryption + diff --git a/gcloud/beta/container/hub/help b/gcloud/beta/container/hub/help index a870a3dd0..67daefc15 100644 --- a/gcloud/beta/container/hub/help +++ b/gcloud/beta/container/hub/help @@ -51,6 +51,9 @@ GROUPS config-management (BETA) Manage Config Management Feature. + dataplane-v2-encryption + (BETA) Manage Dataplane V2 Encryption Feature. + features (BETA) Manage Hub Feature resources. diff --git a/gcloud/beta/container/hub/policycontroller/deployment/remove b/gcloud/beta/container/hub/policycontroller/deployment/remove index 274276e72..c1020de14 100644 --- a/gcloud/beta/container/hub/policycontroller/deployment/remove +++ b/gcloud/beta/container/hub/policycontroller/deployment/remove @@ -64,6 +64,11 @@ EXAMPLES $ gcloud beta container hub policycontroller deployment remove \ audit cpu-request + To remove the anti-affinity configuration: + + $ gcloud beta container hub policycontroller deployment remove \ + admission pod-affinity + POSITIONAL ARGUMENTS DEPLOYMENT The PolicyController deployment component (i.e, "admission", "audit" or diff --git a/gcloud/beta/container/hub/policycontroller/deployment/set b/gcloud/beta/container/hub/policycontroller/deployment/set index d4b178907..74774e025 100644 --- a/gcloud/beta/container/hub/policycontroller/deployment/set +++ b/gcloud/beta/container/hub/policycontroller/deployment/set @@ -72,6 +72,12 @@ EXAMPLES $ gcloud beta container hub policycontroller deployment set audit \ cpu-request 250m + To set anti-affinity to achieve high availability on the mutation + deployment: + + $ gcloud beta container hub policycontroller deployment set \ + mutation pod-affinity anti + POSITIONAL ARGUMENTS DEPLOYMENT The PolicyController deployment component (e.g. "admission", "audit" or diff --git a/gcloud/beta/container/hub/update b/gcloud/beta/container/hub/update index 97b21de41..9ea42cc88 100644 --- a/gcloud/beta/container/hub/update +++ b/gcloud/beta/container/hub/update @@ -4,7 +4,9 @@ NAME SYNOPSIS gcloud beta container hub update [--async] [--display-name=DISPLAY_NAME] [--update-labels=[KEY=VALUE,...]] - [--security-posture=SECURITY_POSTURE + [--binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE + --binauthz-policy-bindings=[name=BINAUTHZ_POLICY,...] + --security-posture=SECURITY_POSTURE --workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] @@ -42,6 +44,22 @@ FLAGS Default cluster configurations to apply across the fleet. + Binary Authorization config. + + --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE + Configure binary authorization mode for clusters to onboard the + fleet, + + $ gcloud beta container hub update \ + --binauthz-evaluation-mode=POLICY_BINDINGS + + BINAUTHZ_EVALUATION_MODE must be one of: DISABLED, POLICY_BINDINGS. + + --binauthz-policy-bindings=[name=BINAUTHZ_POLICY,...] + The relative resource name of the Binary Authorization policy to + audit and/or enforce. GKE policies have the following format: + projects/{project_number}/platforms/gke/policies/{policy_id}. + Security posture config. --security-posture=SECURITY_POSTURE diff --git a/gcloud/beta/container/node-pools/create b/gcloud/beta/container/node-pools/create index 643fe545d..5ef4c2866 100644 --- a/gcloud/beta/container/node-pools/create +++ b/gcloud/beta/container/node-pools/create @@ -21,8 +21,9 @@ SYNOPSIS [--enable-blue-green-upgrade] [--enable-confidential-nodes] [--enable-confidential-storage] [--enable-gvnic] [--enable-image-streaming] [--enable-private-nodes] - [--enable-surge-upgrade] [--image-type=IMAGE_TYPE] - [--labels=[KEY=VALUE,...]] [--logging-variant=LOGGING_VARIANT] + [--enable-queued-provisioning] [--enable-surge-upgrade] + [--image-type=IMAGE_TYPE] [--labels=[KEY=VALUE,...]] + [--logging-variant=LOGGING_VARIANT] [--machine-type=MACHINE_TYPE, -m MACHINE_TYPE] [--max-pods-per-node=MAX_PODS_PER_NODE] [--max-surge-upgrade=MAX_SURGE_UPGRADE; default=1] @@ -252,6 +253,14 @@ FLAGS addresses only, regardless of whether private nodes are enabled or disabled. + --enable-queued-provisioning + Mark the newly created nodepool as Queued only. This means that all new + nodes can be obtained only through queuing via Cluster Autoscaler + ProvisioningRequest API. + + $ gcloud beta container node-pools create node-pool-1 \ + --cluster=example-cluster --enable-queued-provisioning + --enable-surge-upgrade Changes node pool upgrade strategy to surge upgrade. diff --git a/gcloud/beta/domains/registrations/configure/management b/gcloud/beta/domains/registrations/configure/management index 833888634..47149736f 100644 --- a/gcloud/beta/domains/registrations/configure/management +++ b/gcloud/beta/domains/registrations/configure/management @@ -4,19 +4,29 @@ NAME SYNOPSIS gcloud beta domains registrations configure management REGISTRATION - [--async] [--transfer-lock-state=TRANSFER_LOCK_STATE] - [GCLOUD_WIDE_FLAG ...] + [--async] [--preferred-renewal-method=PREFERRED_RENEWAL_METHOD] + [--transfer-lock-state=TRANSFER_LOCK_STATE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Configure management settings of a registration. This includes settings related to transfers, billing and renewals of a registration. EXAMPLES + To start an interactive flow to configure management settings for + example.com, run: + + $ gcloud beta domains registrations configure management example.com + To unlock a transfer lock of a registration for example.com, run: $ gcloud beta domains registrations configure management \ example.com --transfer-lock-state=unlocked + To disable automatic renewals for example.com, run: + + $ gcloud beta domains registrations configure management \ + example.com --preferred-renewal-method=renewal-disabled + POSITIONAL ARGUMENTS Registration resource - The domain registration to configure management settings for. This represents a Cloud resource. (NOTE) Some attributes are @@ -47,6 +57,17 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --preferred-renewal-method=PREFERRED_RENEWAL_METHOD + Preferred Renewal Method of a registration. It defines how the + registration should be renewed. The actual Renewal Method can be set to + renewal-disabled in case of e.g. problems with the Billing Account or + reporeted domain abuse. PREFERRED_RENEWAL_METHOD must be one of: + + automatic-renewal + The domain is automatically renewed each year. + renewal-disabled + The domain won't be renewed and will expire at its expiration time. + --transfer-lock-state=TRANSFER_LOCK_STATE Transfer Lock of a registration. It needs to be unlocked in order to transfer the domain to another registrar. TRANSFER_LOCK_STATE must be diff --git a/gcloud/beta/filestore/instances/create b/gcloud/beta/filestore/instances/create index c954724df..0a7f4fe68 100644 --- a/gcloud/beta/filestore/instances/create +++ b/gcloud/beta/filestore/instances/create @@ -227,9 +227,9 @@ OPTIONAL FLAGS Location of the Cloud Filestore instance/operation. --managed-ad=[computer=COMPUTER],[domain=DOMAIN] - Managed Active Directory configuration for an instance. Specifying both - domain name and a computer name (unique to the domain) to be created by - filestore instance. + Managed Active Directory configuration for an instance. Specifies both + the domain name and a computer name (unique to the domain) to be + created by the filestore instance. domain The desired domain full uri. i.e: @@ -237,7 +237,7 @@ OPTIONAL FLAGS computer The desired active directory computer name to be created by - filestore instance when connecting to the domain. + the filestore instance when connecting to the domain. --protocol=PROTOCOL; default="NFS_V3" The service protocol for the Cloud Filestore instance. PROTOCOL must be @@ -262,8 +262,7 @@ OPTIONAL FLAGS basic-ssd Performant NFS storage system using SSD. enterprise - Enterprise instances offer the features and availability needed for - mission-critical workloads. + Enterprise instance. Use REGIONAL instead whenever possible. high-scale-ssd High Scale SSD instance, an alias for ZONAL. Use ZONAL instead whenever possible. diff --git a/gcloud/beta/filestore/instances/update b/gcloud/beta/filestore/instances/update index b24a9cc08..493db34cc 100644 --- a/gcloud/beta/filestore/instances/update +++ b/gcloud/beta/filestore/instances/update @@ -6,6 +6,8 @@ SYNOPSIS [--description=DESCRIPTION] [--location=LOCATION] [--region=REGION] [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] + [--disconnect-managed-ad + | --managed-ad=[computer=COMPUTER],[domain=DOMAIN]] [[--file-share=[capacity=CAPACITY], [name=NAME],[nfs-export-options=NFS-EXPORT-OPTIONS] : --clear-nfs-export-options]] [GCLOUD_WIDE_FLAG ...] @@ -134,6 +136,24 @@ FLAGS silently ignored. If --update-labels is also specified then --update-labels is applied first. + At most one of these can be specified: + + --disconnect-managed-ad + Disconnect the instance from Managed Active Directory. + + --managed-ad=[computer=COMPUTER],[domain=DOMAIN] + Managed Active Directory configuration for an instance. Specifies + both the domain name and a computer name (unique to the domain) to be + created by the filestore instance. + + domain + The desired domain full uri. i.e: + projects/PROJECT/locations/global/domains/DOMAIN + + computer + The desired active directory computer name to be created by + the filestore instance when connecting to the domain. + Parameters for file-share. --file-share=[capacity=CAPACITY],[name=NAME],[nfs-export-options=NFS-EXPORT-OPTIONS] diff --git a/gcloud/beta/healthcare/hl7v2-stores/help b/gcloud/beta/healthcare/hl7v2-stores/help index 5a1acfba7..86f227f8c 100644 --- a/gcloud/beta/healthcare/hl7v2-stores/help +++ b/gcloud/beta/healthcare/hl7v2-stores/help @@ -43,6 +43,9 @@ COMMANDS list (BETA) List Cloud Healthcare API HL7v2 stores. + metrics + (BETA) Gets the metrics for a Cloud Healthcare API HL7v2 store. + remove-iam-policy-binding (BETA) Remove an IAM policy binding from a Cloud Healthcare API HL7v2 store. diff --git a/gcloud/beta/healthcare/hl7v2-stores/metrics b/gcloud/beta/healthcare/hl7v2-stores/metrics new file mode 100644 index 000000000..1306e7a90 --- /dev/null +++ b/gcloud/beta/healthcare/hl7v2-stores/metrics @@ -0,0 +1,79 @@ +NAME + gcloud beta healthcare hl7v2-stores metrics - gets the metrics for a Cloud + Healthcare API HL7v2 store + +SYNOPSIS + gcloud beta healthcare hl7v2-stores metrics + (HL7V2_STORE : --dataset=DATASET --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Gets the metrics for a Cloud Healthcare API HL7v2 store. + +EXAMPLES + To get metrics for the HL7v2 store 'test-hl7v2-store', run: + + $ gcloud beta healthcare hl7v2-stores metrics test-hl7v2-store \ + --dataset=test-dataset + +POSITIONAL ARGUMENTS + Hl7v2Store resource - Cloud Healthcare API HL7v2 store to get metrics 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 hl7v2_store 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. + + HL7V2_STORE + ID of the hl7v2Store or fully qualified identifier for the + hl7v2Store. + + To set the hl7v2_store attribute: + ▸ provide the argument hl7v2_store on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --dataset=DATASET + Cloud Healthcare dataset. + + To set the dataset attribute: + ▸ provide the argument hl7v2_store on the command line with a fully + specified name; + ▸ provide the argument --dataset on the command line. + + --location=LOCATION + Google Cloud location. + + To set the location attribute: + ▸ provide the argument hl7v2_store on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property healthcare/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the healthcare/v1beta1 API. The full documentation for + this API can be found at: https://cloud.google.com/healthcare + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud healthcare hl7v2-stores metrics + + $ gcloud alpha healthcare hl7v2-stores metrics + diff --git a/gcloud/beta/netapp/active-directories/create b/gcloud/beta/netapp/active-directories/create index ff2aae56e..43e1a7787 100644 --- a/gcloud/beta/netapp/active-directories/create +++ b/gcloud/beta/netapp/active-directories/create @@ -61,8 +61,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument active_directory on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. REQUIRED FLAGS --dns=DNS diff --git a/gcloud/beta/netapp/active-directories/delete b/gcloud/beta/netapp/active-directories/delete index da0bda291..129a36be3 100644 --- a/gcloud/beta/netapp/active-directories/delete +++ b/gcloud/beta/netapp/active-directories/delete @@ -53,8 +53,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument active_directory on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async diff --git a/gcloud/beta/netapp/active-directories/describe b/gcloud/beta/netapp/active-directories/describe index 868575041..0c535f5f6 100644 --- a/gcloud/beta/netapp/active-directories/describe +++ b/gcloud/beta/netapp/active-directories/describe @@ -47,8 +47,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument active_directory on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/netapp/active-directories/list b/gcloud/beta/netapp/active-directories/list index 7fae7bd2a..80ede3633 100644 --- a/gcloud/beta/netapp/active-directories/list +++ b/gcloud/beta/netapp/active-directories/list @@ -25,7 +25,6 @@ FLAGS specified name; ◆ uses all locations by default. with a fully specified name; ◆ set the property netapp/location with a fully specified name; - ◆ set the property netapp/region with a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. @@ -35,8 +34,7 @@ FLAGS To set the location attribute: ▸ provide the argument --location on the command line; ▸ uses all locations by default.; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/beta/netapp/active-directories/update b/gcloud/beta/netapp/active-directories/update index bff50c323..d8884fac5 100644 --- a/gcloud/beta/netapp/active-directories/update +++ b/gcloud/beta/netapp/active-directories/update @@ -63,8 +63,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument active_directory on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. REQUIRED FLAGS --dns=DNS diff --git a/gcloud/beta/netapp/backup-policies/create b/gcloud/beta/netapp/backup-policies/create index c7c289e21..dd664c6c2 100644 --- a/gcloud/beta/netapp/backup-policies/create +++ b/gcloud/beta/netapp/backup-policies/create @@ -54,8 +54,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument backup_policy on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async diff --git a/gcloud/beta/netapp/backup-policies/delete b/gcloud/beta/netapp/backup-policies/delete index 21e6affe0..09520459b 100644 --- a/gcloud/beta/netapp/backup-policies/delete +++ b/gcloud/beta/netapp/backup-policies/delete @@ -51,8 +51,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument backup_policy on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async diff --git a/gcloud/beta/netapp/backup-policies/describe b/gcloud/beta/netapp/backup-policies/describe index aa9fcbf42..f7018f5a4 100644 --- a/gcloud/beta/netapp/backup-policies/describe +++ b/gcloud/beta/netapp/backup-policies/describe @@ -52,8 +52,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument backup_policy on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/netapp/backup-policies/list b/gcloud/beta/netapp/backup-policies/list index 59c4f7aa2..59d72e60e 100644 --- a/gcloud/beta/netapp/backup-policies/list +++ b/gcloud/beta/netapp/backup-policies/list @@ -30,7 +30,6 @@ FLAGS specified name; ◆ uses all locations by default. with a fully specified name; ◆ set the property netapp/location with a fully specified name; - ◆ set the property netapp/region with a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. @@ -40,8 +39,7 @@ FLAGS To set the location attribute: ▸ provide the argument --location on the command line; ▸ uses all locations by default.; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/beta/netapp/backup-policies/update b/gcloud/beta/netapp/backup-policies/update index 719d3638b..276271531 100644 --- a/gcloud/beta/netapp/backup-policies/update +++ b/gcloud/beta/netapp/backup-policies/update @@ -61,8 +61,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument backup_policy on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async diff --git a/gcloud/beta/netapp/backup-vaults/backups/create b/gcloud/beta/netapp/backup-vaults/backups/create index 5176d03de..eeacdc8e1 100644 --- a/gcloud/beta/netapp/backup-vaults/backups/create +++ b/gcloud/beta/netapp/backup-vaults/backups/create @@ -55,8 +55,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument backup on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async @@ -77,8 +76,7 @@ FLAGS ◆ provide the argument --backup-vault on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --backup-vault=BACKUP_VAULT ID of the backup_vault or fully qualified identifier for the @@ -113,8 +111,7 @@ FLAGS To set the location attribute: ◆ provide the argument --source-snapshot on the command line with a fully specified name; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. To set the volume attribute: ◆ provide the argument --source-snapshot on the command line with a @@ -146,8 +143,7 @@ FLAGS ◆ provide the argument --volume on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --source-volume=SOURCE_VOLUME ID of the volume or fully qualified identifier for the volume. diff --git a/gcloud/beta/netapp/backup-vaults/backups/delete b/gcloud/beta/netapp/backup-vaults/backups/delete index 1fa900e09..73d36172f 100644 --- a/gcloud/beta/netapp/backup-vaults/backups/delete +++ b/gcloud/beta/netapp/backup-vaults/backups/delete @@ -56,8 +56,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument backup on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async @@ -78,8 +77,7 @@ FLAGS ◆ provide the argument --backup-vault on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --backup-vault=BACKUP_VAULT ID of the backup_vault or fully qualified identifier for the diff --git a/gcloud/beta/netapp/backup-vaults/backups/describe b/gcloud/beta/netapp/backup-vaults/backups/describe index c905b2949..54ba05b26 100644 --- a/gcloud/beta/netapp/backup-vaults/backups/describe +++ b/gcloud/beta/netapp/backup-vaults/backups/describe @@ -51,8 +51,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument backup on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS Backup vault resource - The Backup Vault that the Backup is stored in This @@ -69,8 +68,7 @@ FLAGS ◆ provide the argument --backup-vault on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --backup-vault=BACKUP_VAULT ID of the backup_vault or fully qualified identifier for the diff --git a/gcloud/beta/netapp/backup-vaults/backups/list b/gcloud/beta/netapp/backup-vaults/backups/list index 3ff3fc9e5..c60c59e31 100644 --- a/gcloud/beta/netapp/backup-vaults/backups/list +++ b/gcloud/beta/netapp/backup-vaults/backups/list @@ -32,8 +32,7 @@ FLAGS ◆ provide the argument --backup-vault on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --backup-vault=BACKUP_VAULT ID of the backup_vault or fully qualified identifier for the @@ -51,7 +50,6 @@ FLAGS specified name; ◆ uses all locations by default. with a fully specified name; ◆ set the property netapp/location with a fully specified name; - ◆ set the property netapp/region with a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. @@ -61,8 +59,7 @@ FLAGS To set the location attribute: ▸ provide the argument --location on the command line; ▸ uses all locations by default.; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/beta/netapp/backup-vaults/backups/update b/gcloud/beta/netapp/backup-vaults/backups/update index 03023b4d9..e8a7716d9 100644 --- a/gcloud/beta/netapp/backup-vaults/backups/update +++ b/gcloud/beta/netapp/backup-vaults/backups/update @@ -52,8 +52,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument backup on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async @@ -74,8 +73,7 @@ FLAGS ◆ provide the argument --backup-vault on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --backup-vault=BACKUP_VAULT ID of the backup_vault or fully qualified identifier for the diff --git a/gcloud/beta/netapp/backup-vaults/create b/gcloud/beta/netapp/backup-vaults/create index 93f7bbf01..ace0a157f 100644 --- a/gcloud/beta/netapp/backup-vaults/create +++ b/gcloud/beta/netapp/backup-vaults/create @@ -49,8 +49,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument backup_vault on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async diff --git a/gcloud/beta/netapp/backup-vaults/delete b/gcloud/beta/netapp/backup-vaults/delete index df391bc6f..5d8184e8d 100644 --- a/gcloud/beta/netapp/backup-vaults/delete +++ b/gcloud/beta/netapp/backup-vaults/delete @@ -51,8 +51,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument backup_vault on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async diff --git a/gcloud/beta/netapp/backup-vaults/describe b/gcloud/beta/netapp/backup-vaults/describe index 8f8b644b7..7aabeb65d 100644 --- a/gcloud/beta/netapp/backup-vaults/describe +++ b/gcloud/beta/netapp/backup-vaults/describe @@ -52,8 +52,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument backup_vault on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/netapp/backup-vaults/list b/gcloud/beta/netapp/backup-vaults/list index 8255befa2..c43595319 100644 --- a/gcloud/beta/netapp/backup-vaults/list +++ b/gcloud/beta/netapp/backup-vaults/list @@ -31,7 +31,6 @@ FLAGS specified name; ◆ uses all locations by default. with a fully specified name; ◆ set the property netapp/location with a fully specified name; - ◆ set the property netapp/region with a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. @@ -41,8 +40,7 @@ FLAGS To set the location attribute: ▸ provide the argument --location on the command line; ▸ uses all locations by default.; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/beta/netapp/backup-vaults/update b/gcloud/beta/netapp/backup-vaults/update index c0139b1bc..0ddabe1be 100644 --- a/gcloud/beta/netapp/backup-vaults/update +++ b/gcloud/beta/netapp/backup-vaults/update @@ -56,8 +56,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument backup_vault on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async diff --git a/gcloud/beta/netapp/kms-configs/create b/gcloud/beta/netapp/kms-configs/create index f33ee46bf..de067ecbe 100644 --- a/gcloud/beta/netapp/kms-configs/create +++ b/gcloud/beta/netapp/kms-configs/create @@ -53,8 +53,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument kms_config on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. REQUIRED FLAGS Kms key resource - The Cloud KMS (Key Management Service) Crypto Key that @@ -88,8 +87,7 @@ REQUIRED FLAGS specified name; ▸ provide the argument --kms-location on the command line; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. --kms-project=KMS_PROJECT The Cloud project for the kms_key. diff --git a/gcloud/beta/netapp/kms-configs/delete b/gcloud/beta/netapp/kms-configs/delete index 65fa06a74..cd60f90e5 100644 --- a/gcloud/beta/netapp/kms-configs/delete +++ b/gcloud/beta/netapp/kms-configs/delete @@ -51,8 +51,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument kms_config on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async diff --git a/gcloud/beta/netapp/kms-configs/describe b/gcloud/beta/netapp/kms-configs/describe index 2c6984c73..285e1241b 100644 --- a/gcloud/beta/netapp/kms-configs/describe +++ b/gcloud/beta/netapp/kms-configs/describe @@ -52,8 +52,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument kms_config on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/netapp/kms-configs/encrypt b/gcloud/beta/netapp/kms-configs/encrypt index 49a6e0fa5..9cdb38a7d 100644 --- a/gcloud/beta/netapp/kms-configs/encrypt +++ b/gcloud/beta/netapp/kms-configs/encrypt @@ -49,8 +49,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument kms_config on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async diff --git a/gcloud/beta/netapp/kms-configs/list b/gcloud/beta/netapp/kms-configs/list index f0ef700cb..d7bccee07 100644 --- a/gcloud/beta/netapp/kms-configs/list +++ b/gcloud/beta/netapp/kms-configs/list @@ -30,7 +30,6 @@ FLAGS specified name; ◆ uses all locations by default. with a fully specified name; ◆ set the property netapp/location with a fully specified name; - ◆ set the property netapp/region with a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. @@ -40,8 +39,7 @@ FLAGS To set the location attribute: ▸ provide the argument --location on the command line; ▸ uses all locations by default.; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/beta/netapp/kms-configs/update b/gcloud/beta/netapp/kms-configs/update index 89e003386..ff4ffeaf4 100644 --- a/gcloud/beta/netapp/kms-configs/update +++ b/gcloud/beta/netapp/kms-configs/update @@ -61,8 +61,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument kms_config on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async @@ -130,8 +129,7 @@ FLAGS specified name; ▸ provide the argument --kms-location on the command line; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. --kms-project=KMS_PROJECT The Cloud project for the kms_key. diff --git a/gcloud/beta/netapp/kms-configs/verify b/gcloud/beta/netapp/kms-configs/verify index e444f36e3..b4ef50dc6 100644 --- a/gcloud/beta/netapp/kms-configs/verify +++ b/gcloud/beta/netapp/kms-configs/verify @@ -48,8 +48,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument kms_config on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/netapp/operations/describe b/gcloud/beta/netapp/operations/describe index d71a9ed18..54efb462a 100644 --- a/gcloud/beta/netapp/operations/describe +++ b/gcloud/beta/netapp/operations/describe @@ -45,8 +45,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument operation on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/netapp/operations/list b/gcloud/beta/netapp/operations/list index 3c6210b85..15bf43f54 100644 --- a/gcloud/beta/netapp/operations/list +++ b/gcloud/beta/netapp/operations/list @@ -24,7 +24,6 @@ FLAGS specified name; ◆ uses all locations by default. with a fully specified name; ◆ set the property netapp/location with a fully specified name; - ◆ set the property netapp/region with a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. @@ -34,8 +33,7 @@ FLAGS To set the location attribute: ▸ provide the argument --location on the command line; ▸ uses all locations by default.; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/beta/netapp/storage-pools/create b/gcloud/beta/netapp/storage-pools/create index 4c2cadbc7..93c51bb68 100644 --- a/gcloud/beta/netapp/storage-pools/create +++ b/gcloud/beta/netapp/storage-pools/create @@ -56,8 +56,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument storage_pool on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. REQUIRED FLAGS --capacity=CAPACITY @@ -111,8 +110,7 @@ OPTIONAL FLAGS ◆ provide the argument --active-directory on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --active-directory=ACTIVE_DIRECTORY ID of the active_directory or fully qualified identifier for the @@ -146,8 +144,7 @@ OPTIONAL FLAGS ◆ provide the argument --kms-config on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --kms-config=KMS_CONFIG ID of the kms_config or fully qualified identifier for the diff --git a/gcloud/beta/netapp/storage-pools/delete b/gcloud/beta/netapp/storage-pools/delete index 66e64edce..b3405ccae 100644 --- a/gcloud/beta/netapp/storage-pools/delete +++ b/gcloud/beta/netapp/storage-pools/delete @@ -51,8 +51,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument storage_pool on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async diff --git a/gcloud/beta/netapp/storage-pools/describe b/gcloud/beta/netapp/storage-pools/describe index 41ba97cd4..3e82b0203 100644 --- a/gcloud/beta/netapp/storage-pools/describe +++ b/gcloud/beta/netapp/storage-pools/describe @@ -47,8 +47,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument storage_pool on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/netapp/storage-pools/list b/gcloud/beta/netapp/storage-pools/list index 9ccdd0144..12ed546c2 100644 --- a/gcloud/beta/netapp/storage-pools/list +++ b/gcloud/beta/netapp/storage-pools/list @@ -24,7 +24,6 @@ FLAGS specified name; ◆ uses all locations by default. with a fully specified name; ◆ set the property netapp/location with a fully specified name; - ◆ set the property netapp/region with a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. @@ -34,8 +33,7 @@ FLAGS To set the location attribute: ▸ provide the argument --location on the command line; ▸ uses all locations by default.; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/beta/netapp/storage-pools/update b/gcloud/beta/netapp/storage-pools/update index e82ee51c5..4ccf29f67 100644 --- a/gcloud/beta/netapp/storage-pools/update +++ b/gcloud/beta/netapp/storage-pools/update @@ -51,8 +51,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument storage_pool on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS Active directory resource - The Active Directory to attach to the Storage @@ -69,8 +68,7 @@ FLAGS ◆ provide the argument --active-directory on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --active-directory=ACTIVE_DIRECTORY ID of the active_directory or fully qualified identifier for the diff --git a/gcloud/beta/netapp/volumes/create b/gcloud/beta/netapp/volumes/create index 379ce3fed..32eb832d2 100644 --- a/gcloud/beta/netapp/volumes/create +++ b/gcloud/beta/netapp/volumes/create @@ -86,8 +86,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument volume on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. REQUIRED FLAGS --capacity=CAPACITY @@ -115,8 +114,7 @@ REQUIRED FLAGS ◆ provide the argument --storage-pool on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. This must be specified. @@ -193,8 +191,10 @@ OPTIONAL FLAGS CONTINUOUSLY_AVAILABLE. --snap-reserve=SNAP_RESERVE - The percentage of volume storage reserved for snapshot storage. The - default value for this is 0 percent + (DEPRECATED) The percentage of volume storage reserved for snapshot + storage. The default value for this is 0 percent + + The snap-reserve option is deprecated --snapshot-daily=[hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP] Make a snapshot every day e.g. at 06:00, 05:20, 23:50 @@ -227,8 +227,7 @@ OPTIONAL FLAGS To set the location attribute: ◆ provide the argument --source-snapshot on the command line with a fully specified name; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. To set the volume attribute: ◆ provide the argument --source-snapshot on the command line with a @@ -258,8 +257,7 @@ OPTIONAL FLAGS To set the location attribute: ◆ provide the argument --source-backup on the command line with a fully specified name; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --source-backup=SOURCE_BACKUP ID of the backup or fully qualified identifier for the backup. diff --git a/gcloud/beta/netapp/volumes/delete b/gcloud/beta/netapp/volumes/delete index fa58b7d82..57ae15eae 100644 --- a/gcloud/beta/netapp/volumes/delete +++ b/gcloud/beta/netapp/volumes/delete @@ -47,8 +47,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument volume on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async diff --git a/gcloud/beta/netapp/volumes/describe b/gcloud/beta/netapp/volumes/describe index 1ddcd7e1c..bc3b454a9 100644 --- a/gcloud/beta/netapp/volumes/describe +++ b/gcloud/beta/netapp/volumes/describe @@ -43,8 +43,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument volume on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/netapp/volumes/list b/gcloud/beta/netapp/volumes/list index 1cf6dca6d..d52a159ce 100644 --- a/gcloud/beta/netapp/volumes/list +++ b/gcloud/beta/netapp/volumes/list @@ -24,7 +24,6 @@ FLAGS specified name; ◆ uses all locations by default. with a fully specified name; ◆ set the property netapp/location with a fully specified name; - ◆ set the property netapp/region with a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. @@ -34,8 +33,7 @@ FLAGS To set the location attribute: ▸ provide the argument --location on the command line; ▸ uses all locations by default.; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/beta/netapp/volumes/replications/create b/gcloud/beta/netapp/volumes/replications/create index 6b1c739e4..0e2e8c3d2 100644 --- a/gcloud/beta/netapp/volumes/replications/create +++ b/gcloud/beta/netapp/volumes/replications/create @@ -61,8 +61,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument replication on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. REQUIRED FLAGS --destination-volume-parameters=[description=DESCRIPTION],[share_name=SHARE_NAME],[storage_pool=STORAGE_POOL],[volume_id=VOLUME_ID] @@ -99,8 +98,7 @@ OPTIONAL FLAGS ◆ provide the argument --volume on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --volume=VOLUME ID of the volume or fully qualified identifier for the volume. diff --git a/gcloud/beta/netapp/volumes/replications/delete b/gcloud/beta/netapp/volumes/replications/delete index fe2d4e442..7da89903b 100644 --- a/gcloud/beta/netapp/volumes/replications/delete +++ b/gcloud/beta/netapp/volumes/replications/delete @@ -59,8 +59,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument replication on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async @@ -81,8 +80,7 @@ FLAGS ◆ provide the argument --volume on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --volume=VOLUME ID of the volume or fully qualified identifier for the volume. diff --git a/gcloud/beta/netapp/volumes/replications/describe b/gcloud/beta/netapp/volumes/replications/describe index 32a07f4ab..eb8d96f5d 100644 --- a/gcloud/beta/netapp/volumes/replications/describe +++ b/gcloud/beta/netapp/volumes/replications/describe @@ -53,8 +53,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument replication on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS Volume resource - The Volume that the Replication is based on This @@ -71,8 +70,7 @@ FLAGS ◆ provide the argument --volume on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --volume=VOLUME ID of the volume or fully qualified identifier for the volume. diff --git a/gcloud/beta/netapp/volumes/replications/list b/gcloud/beta/netapp/volumes/replications/list index 2faa99459..803693445 100644 --- a/gcloud/beta/netapp/volumes/replications/list +++ b/gcloud/beta/netapp/volumes/replications/list @@ -28,7 +28,6 @@ FLAGS specified name; ◆ uses all locations by default. with a fully specified name; ◆ set the property netapp/location with a fully specified name; - ◆ set the property netapp/region with a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. @@ -38,8 +37,7 @@ FLAGS To set the location attribute: ▸ provide the argument --location on the command line; ▸ uses all locations by default.; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. Volume resource - The Volume that the Replication is based on This represents a Cloud resource. (NOTE) Some attributes are not given @@ -55,8 +53,7 @@ FLAGS ◆ provide the argument --volume on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --volume=VOLUME ID of the volume or fully qualified identifier for the volume. diff --git a/gcloud/beta/netapp/volumes/replications/resume b/gcloud/beta/netapp/volumes/replications/resume index 49921f9d6..efebfb3b3 100644 --- a/gcloud/beta/netapp/volumes/replications/resume +++ b/gcloud/beta/netapp/volumes/replications/resume @@ -59,8 +59,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument replication on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async @@ -81,8 +80,7 @@ FLAGS ◆ provide the argument --volume on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --volume=VOLUME ID of the volume or fully qualified identifier for the volume. diff --git a/gcloud/beta/netapp/volumes/replications/reverse b/gcloud/beta/netapp/volumes/replications/reverse index b7654ad9e..f363b9340 100644 --- a/gcloud/beta/netapp/volumes/replications/reverse +++ b/gcloud/beta/netapp/volumes/replications/reverse @@ -59,8 +59,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument replication on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async @@ -81,8 +80,7 @@ FLAGS ◆ provide the argument --volume on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --volume=VOLUME ID of the volume or fully qualified identifier for the volume. diff --git a/gcloud/beta/netapp/volumes/replications/stop b/gcloud/beta/netapp/volumes/replications/stop index 67125296e..b6cd99a7e 100644 --- a/gcloud/beta/netapp/volumes/replications/stop +++ b/gcloud/beta/netapp/volumes/replications/stop @@ -58,8 +58,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument replication on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async @@ -87,8 +86,7 @@ FLAGS ◆ provide the argument --volume on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --volume=VOLUME ID of the volume or fully qualified identifier for the volume. diff --git a/gcloud/beta/netapp/volumes/replications/update b/gcloud/beta/netapp/volumes/replications/update index 8a0486c9d..61e357dde 100644 --- a/gcloud/beta/netapp/volumes/replications/update +++ b/gcloud/beta/netapp/volumes/replications/update @@ -59,8 +59,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument replication on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async @@ -96,8 +95,7 @@ FLAGS ◆ provide the argument --volume on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --volume=VOLUME ID of the volume or fully qualified identifier for the volume. diff --git a/gcloud/beta/netapp/volumes/revert b/gcloud/beta/netapp/volumes/revert index eb437348a..2cfbc6b59 100644 --- a/gcloud/beta/netapp/volumes/revert +++ b/gcloud/beta/netapp/volumes/revert @@ -45,8 +45,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument volume on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. REQUIRED FLAGS Snapshot resource - The Snapshot to revert the Volume back to. This @@ -62,8 +61,7 @@ REQUIRED FLAGS To set the location attribute: ◆ provide the argument --snapshot on the command line with a fully specified name; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. To set the volume attribute: ◆ provide the argument --snapshot on the command line with a fully diff --git a/gcloud/beta/netapp/volumes/snapshots/create b/gcloud/beta/netapp/volumes/snapshots/create index 1ac57a32e..b442964da 100644 --- a/gcloud/beta/netapp/volumes/snapshots/create +++ b/gcloud/beta/netapp/volumes/snapshots/create @@ -52,8 +52,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument snapshot on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async @@ -85,8 +84,7 @@ FLAGS ◆ provide the argument --volume on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --volume=VOLUME ID of the volume or fully qualified identifier for the volume. diff --git a/gcloud/beta/netapp/volumes/snapshots/delete b/gcloud/beta/netapp/volumes/snapshots/delete index 43a1e5c03..4dde9ce40 100644 --- a/gcloud/beta/netapp/volumes/snapshots/delete +++ b/gcloud/beta/netapp/volumes/snapshots/delete @@ -57,8 +57,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument snapshot on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async @@ -79,8 +78,7 @@ FLAGS ◆ provide the argument --volume on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --volume=VOLUME ID of the volume or fully qualified identifier for the volume. diff --git a/gcloud/beta/netapp/volumes/snapshots/describe b/gcloud/beta/netapp/volumes/snapshots/describe index 91e9d0b58..58ff98764 100644 --- a/gcloud/beta/netapp/volumes/snapshots/describe +++ b/gcloud/beta/netapp/volumes/snapshots/describe @@ -52,8 +52,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument snapshot on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS Volume resource - The Volume to take a Snapshot of. This represents a @@ -70,8 +69,7 @@ FLAGS ◆ provide the argument --volume on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --volume=VOLUME ID of the volume or fully qualified identifier for the volume. diff --git a/gcloud/beta/netapp/volumes/snapshots/list b/gcloud/beta/netapp/volumes/snapshots/list index 6254e2838..e2711be11 100644 --- a/gcloud/beta/netapp/volumes/snapshots/list +++ b/gcloud/beta/netapp/volumes/snapshots/list @@ -27,7 +27,6 @@ FLAGS specified name; ◆ uses all locations by default. with a fully specified name; ◆ set the property netapp/location with a fully specified name; - ◆ set the property netapp/region with a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. @@ -37,8 +36,7 @@ FLAGS To set the location attribute: ▸ provide the argument --location on the command line; ▸ uses all locations by default.; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. Volume resource - The Volume to take a Snapshot of. This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this @@ -54,8 +52,7 @@ FLAGS ◆ provide the argument --volume on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --volume=VOLUME ID of the volume or fully qualified identifier for the volume. diff --git a/gcloud/beta/netapp/volumes/snapshots/update b/gcloud/beta/netapp/volumes/snapshots/update index 47e26a503..051499508 100644 --- a/gcloud/beta/netapp/volumes/snapshots/update +++ b/gcloud/beta/netapp/volumes/snapshots/update @@ -54,8 +54,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument snapshot on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async @@ -88,8 +87,7 @@ FLAGS ◆ provide the argument --volume on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --volume=VOLUME ID of the volume or fully qualified identifier for the volume. diff --git a/gcloud/beta/netapp/volumes/update b/gcloud/beta/netapp/volumes/update index 3df25907b..e43eae764 100644 --- a/gcloud/beta/netapp/volumes/update +++ b/gcloud/beta/netapp/volumes/update @@ -78,8 +78,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument volume on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async @@ -150,8 +149,10 @@ FLAGS CONTINUOUSLY_AVAILABLE. --snap-reserve=SNAP_RESERVE - The percentage of volume storage reserved for snapshot storage. The - default value for this is 0 percent + (DEPRECATED) The percentage of volume storage reserved for snapshot + storage. The default value for this is 0 percent + + The snap-reserve option is deprecated --snapshot-daily=[hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP] Make a snapshot every day e.g. at 06:00, 05:20, 23:50 @@ -184,8 +185,7 @@ FLAGS To set the location attribute: ◆ provide the argument --source-snapshot on the command line with a fully specified name; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. To set the volume attribute: ◆ provide the argument --source-snapshot on the command line with a @@ -211,8 +211,7 @@ FLAGS ◆ provide the argument --storage-pool on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --storage-pool=STORAGE_POOL ID of the storage_pool or fully qualified identifier for the @@ -268,8 +267,7 @@ FLAGS To set the location attribute: ◆ provide the argument --source-backup on the command line with a fully specified name; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --source-backup=SOURCE_BACKUP ID of the backup or fully qualified identifier for the backup. diff --git a/gcloud/beta/network-connectivity/help b/gcloud/beta/network-connectivity/help index e6c4f31b0..0d0d8df59 100644 --- a/gcloud/beta/network-connectivity/help +++ b/gcloud/beta/network-connectivity/help @@ -13,6 +13,12 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. +GROUPS + GROUP is one of the following: + + regional-endpoints + (BETA) Manage Network Connectivity RegionalEndpoints. + NOTES This command is currently in beta and might change without notice. These variants are also available: diff --git a/gcloud/beta/network-connectivity/regional-endpoints/create b/gcloud/beta/network-connectivity/regional-endpoints/create new file mode 100644 index 000000000..ffe8cba64 --- /dev/null +++ b/gcloud/beta/network-connectivity/regional-endpoints/create @@ -0,0 +1,101 @@ +NAME + gcloud beta network-connectivity regional-endpoints create - create a new + regional endpoint + +SYNOPSIS + gcloud beta network-connectivity regional-endpoints create + (REGIONAL_ENDPOINT : --region=REGION) + --target-google-api=TARGET_GOOGLE_API [--async] + [--description=DESCRIPTION] [--enable-global-access] + [--labels=[KEY=VALUE,...]] [--network=NETWORK] + [--subnetwork=SUBNETWORK] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create a new regional endpoint with the given name. + +EXAMPLES + To create a regional endpoint with the name 'my-regional-endpoint' in + us-central1 targeting my-target-endpoint, run: + + $ gcloud beta network-connectivity regional-endpoints create \ + my-regional-endpoint --region=us-centeral1 \ + [--network=my-network] [--subnetwork=my-subnet] \ + --target-google-api=my-target-endpoint [--enable-global-access] + +POSITIONAL ARGUMENTS + RegionalEndpoint resource - Name of the regional endpoint to be created. + The arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument regional_endpoint 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. + + REGIONAL_ENDPOINT + ID of the regionalEndpoint or fully qualified identifier for the + regionalEndpoint. + + To set the regional_endpoint attribute: + ▸ provide the argument regional_endpoint on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + The location Id. + + To set the region attribute: + ▸ provide the argument regional_endpoint on the command line with a + fully specified name; + ▸ provide the argument --region on the command line. + +REQUIRED FLAGS + --target-google-api=TARGET_GOOGLE_API + The service endpoint the regional endpoint will connect to. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + Description of the regional endpoint. + + --enable-global-access + Whether the REGIONAL or GLOBAL access is enabled. + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + --network=NETWORK + Consumer's VPC network that this regional endpoint belongs to. + + --subnetwork=SUBNETWORK + The name of the subnetwork from which the IP address will be allocated. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/network-connectivity/regional-endpoints/delete b/gcloud/beta/network-connectivity/regional-endpoints/delete new file mode 100644 index 000000000..01058bb04 --- /dev/null +++ b/gcloud/beta/network-connectivity/regional-endpoints/delete @@ -0,0 +1,70 @@ +NAME + gcloud beta network-connectivity regional-endpoints delete - delete a + regional endpoint + +SYNOPSIS + gcloud beta network-connectivity regional-endpoints delete + (REGIONAL_ENDPOINT : --region=REGION) [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Delete the specified regional endpoint. + +EXAMPLES + To delete a regional endpoint named 'my-regional-endpoint' in us-central1: + + $ gcloud beta network-connectivity regional-endpoints delete \ + my-regional-endpoint --region=us-central1 + +POSITIONAL ARGUMENTS + RegionalEndpoint resource - Name of the regional endpoint to be deleted. + The arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument regional_endpoint 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. + + REGIONAL_ENDPOINT + ID of the regionalEndpoint or fully qualified identifier for the + regionalEndpoint. + + To set the regional_endpoint attribute: + ▸ provide the argument regional_endpoint on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + The location Id. + + To set the region attribute: + ▸ provide the argument regional_endpoint on the command line with a + fully specified name; + ▸ provide the argument --region on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/network-connectivity/regional-endpoints/describe b/gcloud/beta/network-connectivity/regional-endpoints/describe new file mode 100644 index 000000000..edee7e23c --- /dev/null +++ b/gcloud/beta/network-connectivity/regional-endpoints/describe @@ -0,0 +1,66 @@ +NAME + gcloud beta network-connectivity regional-endpoints describe - describe a + regional endpoint + +SYNOPSIS + gcloud beta network-connectivity regional-endpoints describe + (REGIONAL_ENDPOINT : --region=REGION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Retrieve and display details about a regional endpoint. + +EXAMPLES + Display details about a regional endpoint named 'my-regional-endpoint' in + us-central1: + + $ gcloud beta network-connectivity regional-endpoints describe \ + my-regional-endpoint --region=us-central1 [--project=my-project] + +POSITIONAL ARGUMENTS + RegionalEndpoint resource - Name of the regional endpoint to be described. + The arguments in this group can be used to specify the attributes of 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 regional_endpoint 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. + + REGIONAL_ENDPOINT + ID of the regionalEndpoint or fully qualified identifier for the + regionalEndpoint. + + To set the regional_endpoint attribute: + ▸ provide the argument regional_endpoint on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + The location Id. + + To set the region attribute: + ▸ provide the argument regional_endpoint on the command line with a + fully specified name; + ▸ provide the argument --region on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/network-connectivity/regional-endpoints/help b/gcloud/beta/network-connectivity/regional-endpoints/help new file mode 100644 index 000000000..47b6ca7cb --- /dev/null +++ b/gcloud/beta/network-connectivity/regional-endpoints/help @@ -0,0 +1,34 @@ +NAME + gcloud beta network-connectivity regional-endpoints - manage Network + Connectivity RegionalEndpoints + +SYNOPSIS + gcloud beta network-connectivity regional-endpoints COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Network Connectivity RegionalEndpoints. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (BETA) Create a new regional endpoint. + + delete + (BETA) Delete a regional endpoint. + + describe + (BETA) Describe a regional endpoint. + + list + (BETA) List regional endpoints. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/network-connectivity/regional-endpoints/list b/gcloud/beta/network-connectivity/regional-endpoints/list new file mode 100644 index 000000000..c7e061342 --- /dev/null +++ b/gcloud/beta/network-connectivity/regional-endpoints/list @@ -0,0 +1,80 @@ +NAME + gcloud beta network-connectivity regional-endpoints list - list regional + endpoints + +SYNOPSIS + gcloud beta network-connectivity regional-endpoints list --region=REGION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Retrieve and display a list of all regional endpoints in the + specified project. + +EXAMPLES + To list all regional endpoints in us-centeral1, run: + + $ gcloud beta network-connectivity regional-endpoints list \ + --region=us-central1 [--project=my-project] + +REQUIRED FLAGS + Region resource - Region of the regional endpoints to display. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --region 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. + + --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. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/network-security/firewall-endpoints/create b/gcloud/beta/network-security/firewall-endpoints/create index 0ce491316..5590793b0 100644 --- a/gcloud/beta/network-security/firewall-endpoints/create +++ b/gcloud/beta/network-security/firewall-endpoints/create @@ -4,9 +4,10 @@ NAME SYNOPSIS gcloud beta network-security firewall-endpoints create - (FIREWALL_ENDPOINT : --organization=ORGANIZATION --zone=ZONE) [--async] - [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] - [--max-wait=MAX_WAIT; default="60m"] [GCLOUD_WIDE_FLAG ...] + (FIREWALL_ENDPOINT : --organization=ORGANIZATION --zone=ZONE) + --billing-project=BILLING_PROJECT [--async] [--description=DESCRIPTION] + [--labels=[KEY=VALUE,...]] [--max-wait=MAX_WAIT; default="60m"] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Create a firewall endpoint. Successful creation of an endpoint @@ -54,7 +55,13 @@ POSITIONAL ARGUMENTS fully specified name; ▸ provide the argument --zone on the command line. -FLAGS +REQUIRED FLAGS + --billing-project=BILLING_PROJECT + The Google Cloud project ID to use for API enablement check, quota, and + endpoint uptime billing. Overrides the default billing/quota_project + property value for this command invocation. + +OPTIONAL FLAGS --async Return immediately, without waiting for the operation in progress to complete. The default is True. Enabled by default, use --no-async to diff --git a/gcloud/beta/network-security/firewall-endpoints/update b/gcloud/beta/network-security/firewall-endpoints/update index f24ee394e..b52e7e391 100644 --- a/gcloud/beta/network-security/firewall-endpoints/update +++ b/gcloud/beta/network-security/firewall-endpoints/update @@ -6,6 +6,7 @@ SYNOPSIS gcloud beta network-security firewall-endpoints update (FIREWALL_ENDPOINT : --organization=ORGANIZATION --zone=ZONE) [--async] [--description=DESCRIPTION] [--max-wait=MAX_WAIT; default="60m"] + [--update-billing-project=BILLING_PROJECT] [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] @@ -81,6 +82,11 @@ FLAGS specified. See $ gcloud topic datetimes for information on time formats. + --update-billing-project=BILLING_PROJECT + The Google Cloud project ID to use for API enablement check, quota, and + endpoint uptime billing. Overrides the default billing/quota_project + property value for this command invocation. + --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/beta/pubsub/subscriptions/create b/gcloud/beta/pubsub/subscriptions/create index f456b1ea9..54eab03f9 100644 --- a/gcloud/beta/pubsub/subscriptions/create +++ b/gcloud/beta/pubsub/subscriptions/create @@ -13,8 +13,8 @@ SYNOPSIS [--push-auth-token-audience=OPTIONAL_AUDIENCE_OVERRIDE] [--push-endpoint=PUSH_ENDPOINT] [--retain-acked-messages] [[--bigquery-table=BIGQUERY_TABLE - : --drop-unknown-fields --use-topic-schema --write-metadata] - | [--cloud-storage-bucket=CLOUD_STORAGE_BUCKET + : --drop-unknown-fields --write-metadata --use-table-schema + | --use-topic-schema] | [--cloud-storage-bucket=CLOUD_STORAGE_BUCKET : --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX --cloud-storage-max-bytes=CLOUD_STORAGE_MAX_BYTES @@ -166,16 +166,10 @@ OPTIONAL FLAGS in this group are specified. --drop-unknown-fields - When --use-topic-schema is set, whether or not to ignore fields in - the topic schema that do not appear in the BigQuery schema. If - false, then the BigQuery schema must contain all fields that are - also present in the topic schema. Use --no-drop-unknown-fields to - disable this flag. - - --use-topic-schema - Whether or not to use the schema for the subscription's topic (if - it exists) when writing messages to BigQuery. Use - --no-use-topic-schema to disable this flag. + If either --use-topic-schema or --use-table-schema is set, whether + or not to ignore fields in the message that do not appear in the + BigQuery table schema. Use --no-drop-unknown-fields to disable this + flag. --write-metadata Whether or not to write message metadata including message ID, @@ -186,6 +180,20 @@ OPTIONAL FLAGS JSON object in the attributes column. Use --no-write-metadata to disable this flag. + At most one of these can be specified: + + --use-table-schema + Whether or not to use the BigQuery table schema when writing + messages to BigQuery. Use --no-use-table-schema to disable this + flag. + + --use-topic-schema + Whether or not to use the schema for the subscription's topic (if + it exists) when writing messages to BigQuery. If + --drop-unknown-fields is not set, then the BigQuery schema must + contain all fields that are present in the topic schema. Use + --no-use-topic-schema to disable this flag. + Cloud Storage Config Options. The Cloud Pub/Sub service account associated with the enclosing subscription's parent project (i.e., service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must diff --git a/gcloud/beta/pubsub/subscriptions/update b/gcloud/beta/pubsub/subscriptions/update index 3dcc33627..fe2dad385 100644 --- a/gcloud/beta/pubsub/subscriptions/update +++ b/gcloud/beta/pubsub/subscriptions/update @@ -12,8 +12,8 @@ SYNOPSIS [--push-endpoint=PUSH_ENDPOINT] [--retain-acked-messages] [--update-labels=[KEY=VALUE,...]] [--clear-bigquery-config | [--bigquery-table=BIGQUERY_TABLE - : --drop-unknown-fields --use-topic-schema --write-metadata] - | --clear-cloud-storage-config + : --drop-unknown-fields --write-metadata --use-table-schema + | --use-topic-schema] | --clear-cloud-storage-config | [--cloud-storage-bucket=CLOUD_STORAGE_BUCKET : --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX @@ -136,17 +136,11 @@ FLAGS arguments in this group are specified. --drop-unknown-fields - When --use-topic-schema is set, whether or not to ignore fields - in the topic schema that do not appear in the BigQuery schema. If - false, then the BigQuery schema must contain all fields that are - also present in the topic schema. Use --no-drop-unknown-fields to + If either --use-topic-schema or --use-table-schema is set, + whether or not to ignore fields in the message that do not appear + in the BigQuery table schema. Use --no-drop-unknown-fields to disable this flag. - --use-topic-schema - Whether or not to use the schema for the subscription's topic (if - it exists) when writing messages to BigQuery. Use - --no-use-topic-schema to disable this flag. - --write-metadata Whether or not to write message metadata including message ID, publish timestamp, ordering key, and attributes to BigQuery. The @@ -156,6 +150,20 @@ FLAGS JSON object in the attributes column. Use --no-write-metadata to disable this flag. + At most one of these can be specified: + + --use-table-schema + Whether or not to use the BigQuery table schema when writing + messages to BigQuery. Use --no-use-table-schema to disable this + flag. + + --use-topic-schema + Whether or not to use the schema for the subscription's topic + (if it exists) when writing messages to BigQuery. If + --drop-unknown-fields is not set, then the BigQuery schema must + contain all fields that are present in the topic schema. Use + --no-use-topic-schema to disable this flag. + At most one of these can be specified: --clear-cloud-storage-config diff --git a/gcloud/beta/pubsub/topics/create b/gcloud/beta/pubsub/topics/create index a0e8bb722..3f5a49947 100644 --- a/gcloud/beta/pubsub/topics/create +++ b/gcloud/beta/pubsub/topics/create @@ -64,9 +64,11 @@ FLAGS is one of "s", "m", "h", and "d" for seconds, minutes, hours, and days, respectively. If the unit is omitted, seconds is assumed. - --message-storage-policy-allowed-regions=[REGION,...] - A list of one or more Cloud regions where messages are allowed to be - stored at rest. + Options for explicitly specifying the message storage policy for a topic. + + --message-storage-policy-allowed-regions=[REGION,...] + A list of one or more Cloud regions where messages are allowed to be + stored at rest. Schema settings. The schema that messages published to this topic must conform to and the expected message encoding. diff --git a/gcloud/beta/pubsub/topics/update b/gcloud/beta/pubsub/topics/update index 596805ea5..28aba428e 100644 --- a/gcloud/beta/pubsub/topics/update +++ b/gcloud/beta/pubsub/topics/update @@ -184,14 +184,18 @@ FLAGS At most one of these can be specified: - --message-storage-policy-allowed-regions=[REGION,...] - A list of one or more Cloud regions where messages are allowed to be - stored at rest. + Options for explicitly specifying the message storage policy for a + topic. These fields can be set only if the + --recompute-message-storage-policy flag is not set. + + --message-storage-policy-allowed-regions=[REGION,...] + A list of one or more Cloud regions where messages are allowed to + be stored at rest. --recompute-message-storage-policy - If given, Cloud Pub/Sub will recompute the regions where messages can - be stored at rest, based on your organization's "Resource Location - Restriction" policy. + If given, Pub/Sub recomputes the regions where messages can be stored + at rest, based on your organization's "Resource Location Restriction" + policy. Key resource - The Cloud KMS (Key Management Service) cryptokey that will be used to protect the topic. The specified Cloud KMS key should have diff --git a/gcloud/beta/recommender/insights/list b/gcloud/beta/recommender/insights/list index a04acf341..069a6922b 100644 --- a/gcloud/beta/recommender/insights/list +++ b/gcloud/beta/recommender/insights/list @@ -11,20 +11,21 @@ SYNOPSIS DESCRIPTION (BETA) This command lists all insights for a given cloud entity, location - and insight type. Supported insight-types can be found here: - https://cloud.google.com/recommender/docs/insights/insight-types. Currently - the following cloud_entity_types are supported: project, billing_account, - folder and organization. + and insight type. If insight-type is not specified, insights for all + supported insight-types are listed. Supported insight-types can be found + here: https://cloud.google.com/recommender/docs/insights/insight-types. + Currently the following cloud_entity_types are supported: project, + billing_account, folder and organization. EXAMPLES To list all insights for a billing account: - $ gcloud beta recommender insights list --project=project-name \ + $ gcloud beta recommender insights list --project=project-id \ --location=global --insight-type=google.compute.firewall.Insight REQUIRED FLAGS --location=LOCATION - Location + Location to list insights for. Resource that is associated with cloud entity type. Currently four mutually exclusive flags are supported, --project, --billing-account, diff --git a/gcloud/beta/recommender/insights/mark-accepted b/gcloud/beta/recommender/insights/mark-accepted index 486c85e97..96a09b1a6 100644 --- a/gcloud/beta/recommender/insights/mark-accepted +++ b/gcloud/beta/recommender/insights/mark-accepted @@ -18,7 +18,7 @@ EXAMPLES To mark an insight as ACCEPTED: $ gcloud beta recommender insights mark-accepted abcd-1234 \ - --project=project-name --location=global \ + --project=project-id --location=global \ --insight-type=google.compute.firewall.Insight --etag=abc123 POSITIONAL ARGUMENTS diff --git a/gcloud/beta/recommender/recommendations/list b/gcloud/beta/recommender/recommendations/list index 916cb92bc..485d7b96f 100644 --- a/gcloud/beta/recommender/recommendations/list +++ b/gcloud/beta/recommender/recommendations/list @@ -12,19 +12,20 @@ SYNOPSIS DESCRIPTION (BETA) This command lists all recommendations for a given cloud_entity_id, - location and recommender. Supported recommenders can be found here: - https://cloud.google.com/recommender/docs/recommenders. Currently the - following cloud_entity_types are supported: project, billing_account, - folder and organization. + location, and recommender. If recommender is not specified, recommendations + for all supported recommenders are listed. Supported recommenders can be + found here: https://cloud.google.com/recommender/docs/recommenders. + Currently the following cloud_entity_types are supported: project, + billing_account, folder and organization. EXAMPLES Lists recommendations for a Cloud project. $ gcloud beta recommender recommendations list \ - --project=project-name --location=global \ + --project=project-id --location=global \ --recommender=google.compute.instance.MachineTypeRecommender REQUIRED FLAGS --location=LOCATION - Location + Location to list recommendations for. Resource that is associated with cloud entity type. Currently four mutually exclusive flags are supported, --project, --billing-account, @@ -49,7 +50,7 @@ REQUIRED FLAGS FLAGS --recommender=RECOMMENDER Recommender to list recommendations for. If no recommender is - specified, recommendations for all supported recommenders is listed. + specified, recommendations for all supported recommenders are listed. Supported recommenders can be found here: https://cloud.google.com/recommender/docs/recommenders diff --git a/gcloud/beta/recommender/recommendations/mark-claimed b/gcloud/beta/recommender/recommendations/mark-claimed index 7457af462..c00f0c797 100644 --- a/gcloud/beta/recommender/recommendations/mark-claimed +++ b/gcloud/beta/recommender/recommendations/mark-claimed @@ -19,8 +19,8 @@ DESCRIPTION EXAMPLES To mark a recommendation as CLAIMED: - $ gcloud beta recommender recommendations mark-claimed \ - RECOMMENDATION --project=project-name --location=global \ + $ gcloud beta recommender recommendations mark-claimed abcd-1234 \ + --project=project-id --location=global \ --recommender=google.compute.instance.MachineTypeRecommender \ --etag=abc123 --state-metadata=key1=value1,key2=value2 diff --git a/gcloud/beta/recommender/recommendations/mark-dismissed b/gcloud/beta/recommender/recommendations/mark-dismissed index d8e6d2dbc..a339ca975 100644 --- a/gcloud/beta/recommender/recommendations/mark-dismissed +++ b/gcloud/beta/recommender/recommendations/mark-dismissed @@ -19,7 +19,7 @@ EXAMPLES To mark a recommendation as DISMISSED: $ gcloud beta recommender recommendations mark-dismissed abcd-1234 \ - --project=project-name --location=global \ + --project=project-id --location=global \ --recommender=google.compute.instance.MachineTypeRecommender \ --etag=abc123 diff --git a/gcloud/beta/recommender/recommendations/mark-failed b/gcloud/beta/recommender/recommendations/mark-failed index 8584fb149..9316d0a27 100644 --- a/gcloud/beta/recommender/recommendations/mark-failed +++ b/gcloud/beta/recommender/recommendations/mark-failed @@ -17,7 +17,7 @@ EXAMPLES To mark a recommendation as FAILED: $ gcloud beta recommender recommendations mark-failed abcd-1234 \ - --project=project-name --location=global \ + --project=project-id --location=global \ --recommender=google.compute.instance.MachineTypeRecommender \ --etag=abc123 --state-metadata=key1=value1,key2=value2 diff --git a/gcloud/beta/recommender/recommendations/mark-succeeded b/gcloud/beta/recommender/recommendations/mark-succeeded index dfa1020db..cada03415 100644 --- a/gcloud/beta/recommender/recommendations/mark-succeeded +++ b/gcloud/beta/recommender/recommendations/mark-succeeded @@ -17,7 +17,7 @@ EXAMPLES To mark a recommendation as SUCCEEDED: $ gcloud beta recommender recommendations mark-succeeded abcd-1234 \ - --project=project-name --location=global \ + --project=project-id --location=global \ --recommender=google.compute.instance.MachineTypeRecommender \ --etag=abc123 --state-metadata=key1=value1,key2=value2 diff --git a/gcloud/beta/services/api-keys/create b/gcloud/beta/services/api-keys/create index 0bc543c00..01451fec4 100644 --- a/gcloud/beta/services/api-keys/create +++ b/gcloud/beta/services/api-keys/create @@ -3,7 +3,7 @@ NAME SYNOPSIS gcloud beta services api-keys create [--annotations=[KEY=VALUE,...]] - [--async] [--display-name=DISPLAY_NAME] + [--async] [--display-name=DISPLAY_NAME] [--key-id=KEY_ID] [--api-target=service=SERVICE,[...] --allowed-application=[sha1_fingerprint=SHA1_FINGERPRINT, package_name=PACKAGE_NAME,...] @@ -24,6 +24,10 @@ EXAMPLES $ gcloud beta services api-keys create --annotations=foo=bar,abc=def + To create a key with user-specified key id: + + $ gcloud beta services api-keys create --key-id="my-key-id" + To create a key with allowed referrers restriction: $ gcloud beta services api-keys create \ @@ -76,6 +80,9 @@ FLAGS --display-name=DISPLAY_NAME Display name of the key to create. + --key-id=KEY_ID + User-specified ID of the key to create. + --api-target=service=SERVICE,[...] Repeatable. Specify service and optionally one or multiple specific methods. Both fields are case insensitive. If you need to specify @@ -109,8 +116,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud services api-keys create $ gcloud alpha services api-keys create diff --git a/gcloud/beta/services/api-keys/delete b/gcloud/beta/services/api-keys/delete index 9ab48e9f0..dc6613c34 100644 --- a/gcloud/beta/services/api-keys/delete +++ b/gcloud/beta/services/api-keys/delete @@ -5,6 +5,9 @@ SYNOPSIS gcloud beta services api-keys delete (KEY : --location=LOCATION) [--async] [GCLOUD_WIDE_FLAG ...] +DESCRIPTION + (BETA) Delete an API key. + EXAMPLES Delete an API Key : @@ -59,8 +62,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud services api-keys delete $ gcloud alpha services api-keys delete diff --git a/gcloud/beta/services/api-keys/get-key-string b/gcloud/beta/services/api-keys/get-key-string index 52026ccee..0a3c56297 100644 --- a/gcloud/beta/services/api-keys/get-key-string +++ b/gcloud/beta/services/api-keys/get-key-string @@ -6,6 +6,9 @@ SYNOPSIS gcloud beta services api-keys get-key-string (KEY : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] +DESCRIPTION + (BETA) Get the key string of an API key + EXAMPLES To get the key string of API key 1234, run: @@ -58,8 +61,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud services api-keys get-key-string $ gcloud alpha services api-keys get-key-string diff --git a/gcloud/beta/services/api-keys/update b/gcloud/beta/services/api-keys/update index 7f0e55335..124db12f2 100644 --- a/gcloud/beta/services/api-keys/update +++ b/gcloud/beta/services/api-keys/update @@ -160,8 +160,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud services api-keys update $ gcloud alpha services api-keys update diff --git a/gcloud/beta/source/repos/clone b/gcloud/beta/source/repos/clone index 967287798..206ef449a 100644 --- a/gcloud/beta/source/repos/clone +++ b/gcloud/beta/source/repos/clone @@ -29,7 +29,7 @@ EXAMPLES $ cd DIRECTORY_NAME ... create/edit files and create one or more \ commits ... - $ git push origin master + $ git push origin main POSITIONAL ARGUMENTS REPOSITORY_NAME diff --git a/gcloud/beta/workstations/configs/create b/gcloud/beta/workstations/configs/create index 639cac0a1..a598f2030 100644 --- a/gcloud/beta/workstations/configs/create +++ b/gcloud/beta/workstations/configs/create @@ -11,8 +11,8 @@ SYNOPSIS [--container-env=[CONTAINER_ENV,...]] [--container-run-as-user=CONTAINER_RUN_AS_USER] [--container-working-dir=CONTAINER_WORKING_DIR] - [--disable-public-ip-addresses] [--enable-confidential-compute] - [--enable-nested-virtualization] + [--disable-public-ip-addresses] [--enable-audit-agent] + [--enable-confidential-compute] [--enable-nested-virtualization] [--idle-timeout=IDLE_TIMEOUT; default=7200] [--labels=[LABELS,...]] [--machine-type=MACHINE_TYPE; default="e2-standard-4"] [--network-tags=[NETWORK_TAGS,...]] @@ -139,6 +139,11 @@ FLAGS Default value is false. If set, instances will have no public IP address. + --enable-audit-agent + Whether to enable Linux auditd logging on the workstation. When + enabled, a service account must also be specified that has + logging.buckets.write permission on the project. + --enable-confidential-compute Default value is false. If set, instances will have confidential compute enabled. diff --git a/gcloud/beta/workstations/configs/update b/gcloud/beta/workstations/configs/update index a16565036..f7fee2035 100644 --- a/gcloud/beta/workstations/configs/update +++ b/gcloud/beta/workstations/configs/update @@ -11,11 +11,12 @@ SYNOPSIS [--container-env=[CONTAINER_ENV,...]] [--container-run-as-user=CONTAINER_RUN_AS_USER] [--container-working-dir=CONTAINER_WORKING_DIR] - [--disable-public-ip-addresses] [--enable-confidential-compute] - [--enable-nested-virtualization] [--idle-timeout=IDLE_TIMEOUT] - [--labels=[LABELS,...]] [--machine-type=MACHINE_TYPE] - [--network-tags=[NETWORK_TAGS,...]] [--pool-size=POOL_SIZE] - [--running-timeout=RUNNING_TIMEOUT] [--service-account=SERVICE_ACCOUNT] + [--disable-public-ip-addresses] [--enable-audit-agent] + [--enable-confidential-compute] [--enable-nested-virtualization] + [--idle-timeout=IDLE_TIMEOUT] [--labels=[LABELS,...]] + [--machine-type=MACHINE_TYPE] [--network-tags=[NETWORK_TAGS,...]] + [--pool-size=POOL_SIZE] [--running-timeout=RUNNING_TIMEOUT] + [--service-account=SERVICE_ACCOUNT] [--service-account-scopes=[SERVICE_ACCOUNT_SCOPES,...]] [--shielded-integrity-monitoring] [--shielded-secure-boot] [--shielded-vtpm] @@ -126,6 +127,11 @@ FLAGS Default value is false. If set, instances will have no public IP address. + --enable-audit-agent + Whether to enable Linux auditd logging on the workstation. When + enabled, a service account must also be specified that has + logging.buckets.write permission on the project. + --enable-confidential-compute Default value is false. If set, instances will have confidential compute enabled. diff --git a/gcloud/certificate-manager/trust-configs/create b/gcloud/certificate-manager/trust-configs/create new file mode 100644 index 000000000..15be79e4f --- /dev/null +++ b/gcloud/certificate-manager/trust-configs/create @@ -0,0 +1,106 @@ +NAME + gcloud certificate-manager trust-configs create - create TrustConfig + +SYNOPSIS + gcloud certificate-manager trust-configs create + (TRUST_CONFIG : --location=LOCATION) + --trust-store=[intermediate-cas=INTERMEDIATE-CAS], + [trust-anchors=TRUST-ANCHORS] [--async] [--description=DESCRIPTION] + [--labels=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a TrustConfig. + +EXAMPLES + To create a TrustConfig from PEM certificate files, run: + + $ gcloud certificate-manager trust-configs create my-trust-config \ + --description="my description" \ + --labels=my-key1=my-value1,my-key2=my-value2 \ + --trust-store=trust-anchors=ta.pem,\ + intermediate-cas="ica1.pem;ica2.pem" + +POSITIONAL ARGUMENTS + TrustConfig resource - Name of the TrustConfig to create. The arguments in + this group can be used to specify the attributes of this resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. + + To set the project attribute: + ◆ provide the argument trust_config on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + TRUST_CONFIG + ID of the trustConfig or fully qualified identifier for the + trustConfig. + + To set the trust_config attribute: + ▸ provide the argument trust_config on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Certificate Manager location. + + To set the location attribute: + ▸ provide the argument trust_config on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ default value of location is [global]. + +REQUIRED FLAGS + --trust-store=[intermediate-cas=INTERMEDIATE-CAS],[trust-anchors=TRUST-ANCHORS] + Trust Store with the given trust anchor and intermediate CA PEM-encoded + certificates. Certificates should be provided in files. For multiple + file names, separate them by a semicolon (';') and quote them ('"'). + One file can contain multiple certificates. Intermediate CAs are + optional. + + Examples: + + Single files: --trust-store trust-anchors=ta.pem,intermediate-cas=ica.pem + + No intermediate CAs: --trust-store trust-anchors=ta.pem + + Multiple files: --trust-store trust-anchors="ta1.pem;ta2.pem",intermediate-cas="ica1.pem;ica2.pem" + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + Human-readable description of the resource. + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the certificatemanager/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/certificate-manager + +NOTES + These variants are also available: + + $ gcloud alpha certificate-manager trust-configs create + + $ gcloud beta certificate-manager trust-configs create + diff --git a/gcloud/certificate-manager/trust-configs/help b/gcloud/certificate-manager/trust-configs/help index e9e7234ec..1c71cb1fb 100644 --- a/gcloud/certificate-manager/trust-configs/help +++ b/gcloud/certificate-manager/trust-configs/help @@ -16,6 +16,9 @@ GCLOUD WIDE FLAGS COMMANDS COMMAND is one of the following: + create + Create TrustConfig. + delete Delete TrustConfig. diff --git a/gcloud/composer/environments/run b/gcloud/composer/environments/run index 4033b9635..a5a862b3c 100644 --- a/gcloud/composer/environments/run +++ b/gcloud/composer/environments/run @@ -82,15 +82,15 @@ POSITIONAL ARGUMENTS (listed with Airflow versions that support): backfill [**, 2.0.0), clear [**, 2.0.0), connections [**, 3.0.0), dag_state [**, 2.0.0), dags [1.10.14, 3.0.0), db [2.3.0, 3.0.0), delete_dag [1.10.1, 2.0.0), - kerberos [**, 3.0.0), kubernetes [2.1.4, 3.0.0), list_dag_runs [1.10.2, - 2.0.0), list_dags [**, 2.0.0), list_tasks [**, 2.0.0), next_execution - [1.10.2, 2.0.0), pause [**, 2.0.0), pool [**, 2.0.0), pools [1.10.14, - 3.0.0), render [**, 2.0.0), roles [2.0.0, 3.0.0), run [**, 2.0.0), - sync-perm [1.10.14, 3.0.0), sync_perm [1.10.2, 2.0.0), task_failed_deps - [**, 2.0.0), task_state [**, 2.0.0), tasks [1.10.14, 3.0.0), test [**, - 2.0.0), trigger_dag [**, 2.0.0), unpause [**, 2.0.0), upgrade_check - [1.10.15, 2.0.0), users [1.10.14, 3.0.0), variables [**, 3.0.0), - version [**, 3.0.0) (see + kerberos [**, 3.0.0), kubernetes [2.1.4, 3.0.0), list-import-errors + [**, 3.0.0), list_dag_runs [1.10.2, 2.0.0), list_dags [**, 2.0.0), + list_tasks [**, 2.0.0), next_execution [1.10.2, 2.0.0), pause [**, + 2.0.0), pool [**, 2.0.0), pools [1.10.14, 3.0.0), render [**, 2.0.0), + roles [2.0.0, 3.0.0), run [**, 2.0.0), sync-perm [1.10.14, 3.0.0), + sync_perm [1.10.2, 2.0.0), task_failed_deps [**, 2.0.0), task_state + [**, 2.0.0), tasks [1.10.14, 3.0.0), test [**, 2.0.0), trigger_dag [**, + 2.0.0), unpause [**, 2.0.0), upgrade_check [1.10.15, 2.0.0), users + [1.10.14, 3.0.0), variables [**, 3.0.0), version [**, 3.0.0) (see https://airflow.apache.org/docs/apache-airflow/stable/cli-and-env-variables-ref.html for more info). diff --git a/gcloud/compute/addresses/describe b/gcloud/compute/addresses/describe index eca7fb218..774c96c2a 100644 --- a/gcloud/compute/addresses/describe +++ b/gcloud/compute/addresses/describe @@ -1,14 +1,14 @@ NAME - gcloud compute addresses describe - display detailed information about an - address + gcloud compute addresses describe - display detailed information about a + reserved static address SYNOPSIS gcloud compute addresses describe NAME [--global | --region=REGION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - gcloud compute addresses describe displays all data associated with an - address in a project. + gcloud compute addresses describe displays all data associated with a + reserved static address in a project. EXAMPLES To get details about a global address, run: diff --git a/gcloud/compute/addresses/help b/gcloud/compute/addresses/help index 552b70ebb..e897d06c3 100644 --- a/gcloud/compute/addresses/help +++ b/gcloud/compute/addresses/help @@ -28,7 +28,7 @@ COMMANDS Release reserved IP addresses. describe - Display detailed information about an address. + Display detailed information about a reserved static address. list List addresses. diff --git a/gcloud/compute/instances/stop b/gcloud/compute/instances/stop index f0e9cf246..a8b3ba1b2 100644 --- a/gcloud/compute/instances/stop +++ b/gcloud/compute/instances/stop @@ -9,10 +9,22 @@ SYNOPSIS DESCRIPTION gcloud compute instances stop is used to stop a Compute Engine virtual machine. Stopping a VM performs a clean shutdown, much like invoking the - shutdown functionality of a workstation or laptop. Stopping a VM with a - local SSD is not supported and will result in an API error unless the - --discard-local-ssd flag is passed. Stopping a VM which is already stopped - will return without errors. + shutdown functionality of a workstation or laptop. + + If a VM has any attached Local SSD disks, you must use the + --discard-local-ssd flag to indicate whether or not the Local SSD data + should be discarded. To stop the VM and preserve the Local SSD data when + you stop the VM by setting --discard-local-ssd=False. + + To stop the VM and discard the Local SSD data, specify + --discard-local-ssd=True. + + Preserving the Local SSD disk data incurs costs and is subject to + limitations. See + https://cloud.google.com/compute/docs/disks/local-ssd#stop_instance for + more information. + + Stopping a VM which is already stopped will return without errors. EXAMPLES To stop an instance named test-instance, run: diff --git a/gcloud/compute/instances/suspend b/gcloud/compute/instances/suspend index caf76eeb1..bdfa4bd06 100644 --- a/gcloud/compute/instances/suspend +++ b/gcloud/compute/instances/suspend @@ -17,8 +17,17 @@ DESCRIPTION Note: A suspended instance can be resumed by running the gcloud compute instances resume command. - Limitations: See this feature's restrictions at - https://cloud.google.com/compute/docs/instances/suspend-resume-instance#limitations + If a VM has any attached Local SSD disks, you can preserve the Local SSD + data when you suspend the VM by setting --discard-local-ssd=False. + Preserving the Local SSD disk data incurs costs and is subject to + limitations. + + Limitations: + + ▪ Limitations for suspending a VM: + https://cloud.google.com/compute/docs/instances/suspend-resume-instance#limitations + ▪ Limitations for preserving Local SSD data: + https://cloud.google.com/compute/docs/disks/local-ssd#stop_instance EXAMPLES To suspend an instance named test-instance, run: @@ -30,7 +39,7 @@ EXAMPLES $ gcloud compute instances suspend test-instance \ --discard-local-ssd=True - Using '--discard-local-ssd' without a value defaults to True. + Using --discard-local-ssd without a value defaults to True. POSITIONAL ARGUMENTS INSTANCE_NAMES [INSTANCE_NAMES ...] diff --git a/gcloud/compute/network-endpoint-groups/create b/gcloud/compute/network-endpoint-groups/create index a45c2ba00..71d8e7a9b 100644 --- a/gcloud/compute/network-endpoint-groups/create +++ b/gcloud/compute/network-endpoint-groups/create @@ -98,16 +98,16 @@ FLAGS Default port, network, and subnet are not effective for serverless endpoints. + private-service-connect + The network endpoint corresponds to a service outside the VPC, + accessed via Private Service Connect. + gce-vm-ip Endpoint must be the IP address of a VM's network interface in Compute Engine. Instance reference is required. The IP address is optional. If unspecified, the primary NIC address is used. A port must not be specified. - private-service-connect - The network endpoint corresponds to a service outside the VPC, - accessed via Private Service Connect. - NETWORK_ENDPOINT_TYPE must be one of: gce-vm-ip-port, internet-ip-port, internet-fqdn-port, non-gcp-private-ip-port, serverless, gce-vm-ip, private-service-connect. diff --git a/gcloud/compute/networks/subnets/create b/gcloud/compute/networks/subnets/create index 80b8b9ee6..f0526dfaf 100644 --- a/gcloud/compute/networks/subnets/create +++ b/gcloud/compute/networks/subnets/create @@ -108,6 +108,8 @@ OPTIONAL FLAGS Reserved for Internal HTTP(S) Load Balancing. PRIVATE Regular user created or automatically created subnet. + PRIVATE_NAT + Reserved for use as source range for Private NAT. PRIVATE_SERVICE_CONNECT Reserved for Private Service Connect Internal Load Balancing. REGIONAL_MANAGED_PROXY diff --git a/gcloud/compute/routers/nats/create b/gcloud/compute/routers/nats/create index ff839e064..e5a2de958 100644 --- a/gcloud/compute/routers/nats/create +++ b/gcloud/compute/routers/nats/create @@ -3,10 +3,8 @@ NAME SYNOPSIS gcloud compute routers nats create NAME --router=ROUTER - (--auto-allocate-nat-external-ips - | --nat-external-ip-pool=IP_ADDRESS,[IP_ADDRESS,...]) (--nat-all-subnet-ip-ranges - | --nat-custom-subnet-ip-ranges=SUBNETWORK[:RANGE_NAME],[...] + | --nat-custom-subnet-ip-ranges=SUBNETWORK[:RANGE_NAME|:ALL],[...] | --nat-primary-subnet-ip-ranges) [--async] [--auto-network-tier=AUTO_NETWORK_TIER] [--[no-]enable-dynamic-port-allocation] @@ -18,7 +16,10 @@ SYNOPSIS [--tcp-established-idle-timeout=TCP_ESTABLISHED_IDLE_TIMEOUT] [--tcp-time-wait-timeout=TCP_TIME_WAIT_TIMEOUT] [--tcp-transitory-idle-timeout=TCP_TRANSITORY_IDLE_TIMEOUT] - [--udp-idle-timeout=UDP_IDLE_TIMEOUT] [GCLOUD_WIDE_FLAG ...] + [--type=TYPE] [--udp-idle-timeout=UDP_IDLE_TIMEOUT] + [--auto-allocate-nat-external-ips + | --nat-external-ip-pool=IP_ADDRESS,[IP_ADDRESS,...]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION gcloud compute routers nats create is used to create a NAT on a Compute @@ -55,24 +56,18 @@ REQUIRED FLAGS --router=ROUTER The Router to use for NAT. - Exactly one of these must be specified: - - --auto-allocate-nat-external-ips - Automatically allocate external IP addresses for Cloud NAT - - --nat-external-ip-pool=IP_ADDRESS,[IP_ADDRESS,...] - External IP Addresses to use for Cloud NAT - Exactly one of these must be specified: --nat-all-subnet-ip-ranges Allow all IP ranges of all subnetworks in the region, including primary and secondary ranges, to use NAT. - --nat-custom-subnet-ip-ranges=SUBNETWORK[:RANGE_NAME],[...] + --nat-custom-subnet-ip-ranges=SUBNETWORK[:RANGE_NAME|:ALL],[...] List of subnetwork primary and secondary IP ranges to be allowed to use NAT. + ▸ SUBNETWORK:ALL - specifying a subnetwork name with ALL includes + the primary range and all secondary ranges of the subnet. ▸ SUBNETWORK - including a subnetwork name includes only the primary subnet range of the subnetwork. ▸ SUBNETWORK:RANGE_NAME - specifying a subnetwork and secondary @@ -221,11 +216,30 @@ OPTIONAL FLAGS https://cloud.google.com/sdk/gcloud/reference/topic/datetimes for information on duration formats. + --type=TYPE + Type of the NAT Gateway. Defaults to PUBLIC if not specified. TYPE must + be one of: + + PRIVATE + Used for private-to-private NAT translations. Allows communication + between VPC Networks. + PUBLIC + Used for private-to-public NAT translations. Allows VM instances to + communicate with the internet. + --udp-idle-timeout=UDP_IDLE_TIMEOUT Timeout for UDP connections. See https://cloud.google.com/sdk/gcloud/reference/topic/datetimes for information on duration formats. + At most one of these can be specified: + + --auto-allocate-nat-external-ips + Automatically allocate external IP addresses for Cloud NAT + + --nat-external-ip-pool=IP_ADDRESS,[IP_ADDRESS,...] + External IP Addresses to use for Cloud NAT + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/compute/routers/nats/rules/create b/gcloud/compute/routers/nats/rules/create index 31527e14d..d5ff74b8b 100644 --- a/gcloud/compute/routers/nats/rules/create +++ b/gcloud/compute/routers/nats/rules/create @@ -4,9 +4,10 @@ NAME SYNOPSIS gcloud compute routers nats rules create RULE_NUMBER --match=MATCH - --nat=NAT --router=ROUTER - --source-nat-active-ips=IP_ADDRESS,[IP_ADDRESS,...] [--async] - [--region=REGION] [GCLOUD_WIDE_FLAG ...] + --nat=NAT --router=ROUTER [--async] [--region=REGION] + [--source-nat-active-ips=IP_ADDRESS,[IP_ADDRESS,...]] + [--source-nat-active-ranges=SUBNETWORK,[SUBNETWORK,...]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION gcloud compute routers nats rules create is used to create a Rule on a @@ -28,27 +29,29 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --match=MATCH CEL Expression used to identify traffic to which this rule applies. - ◆ Supported attributes: destination.ip - ◆ Supported operators: ||, == - ◆ Supported methods: inIpRange - Examples of allowed Match expressions: + ◆ Supported attributes (Public NAT): destination.ip + ◆ Supported attributes (Private NAT): nexthop.hub + ◆ Supported methods (Public Nat): inIpRange + ◆ Supported operators (Public NAT): ||, == + ◆ Supported operators (Private NAT): == + + Examples of allowed Match expressions (Public NAT): ◆ 'inIpRange(destination.ip, "203.0.113.0/24")'' ◆ 'destination.ip == "203.0.113.7"' ◆ 'destination.ip == "203.0.113.7" || inIpRange(destination.ip, "203.0.113.16/25")' + Example of allowed Match expression (Private NAT): + ◆ nexthop.hub == + "//networkconnectivity.googleapis.com/projects/p1/locations/global/hubs/h1" + --nat=NAT Name of the NAT that contains the Rule --router=ROUTER The Router to use for NAT. - --source-nat-active-ips=IP_ADDRESS,[IP_ADDRESS,...] - External IP Addresses to use for connections matching this rule. - - These must be valid reserved external IPs in the same region. - OPTIONAL FLAGS --async Return immediately, without waiting for the operation in progress to @@ -74,6 +77,21 @@ OPTIONAL FLAGS Alternatively, the region can be stored in the environment variable CLOUDSDK_COMPUTE_REGION. + --source-nat-active-ips=IP_ADDRESS,[IP_ADDRESS,...] + External IP Addresses to use for connections matching this rule. This + flag is supported only for Public NAT and is required when creating a + Public NAT gateway. + + These must be valid reserved external IP addresses in the same region. + + --source-nat-active-ranges=SUBNETWORK,[SUBNETWORK,...] + Subnetworks from which addresses are used for connections matching this + rule. This flag is supported only for Private NAT and is required when + creating a Private NAT gateway. + + These must be subnetwork resources in the same region, with purpose set + to PRIVATE_NAT. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/compute/routers/nats/rules/update b/gcloud/compute/routers/nats/rules/update index a7a43eb59..36b35836b 100644 --- a/gcloud/compute/routers/nats/rules/update +++ b/gcloud/compute/routers/nats/rules/update @@ -6,8 +6,11 @@ SYNOPSIS gcloud compute routers nats rules update RULE_NUMBER --nat=NAT --router=ROUTER [--async] [--match=MATCH] [--region=REGION] [--source-nat-active-ips=IP_ADDRESS,[IP_ADDRESS,...]] + [--source-nat-active-ranges=SUBNETWORK,[SUBNETWORK,...]] [--clear-source-nat-drain-ips | --source-nat-drain-ips=IP_ADDRESS,[IP_ADDRESS,...]] + [--clear-source-nat-drain-ranges + | --source-nat-drain-ranges=SUBNETWORK,[SUBNETWORK,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -41,16 +44,23 @@ OPTIONAL FLAGS --match=MATCH CEL Expression used to identify traffic to which this rule applies. - ◆ Supported attributes: destination.ip - ◆ Supported operators: ||, == - ◆ Supported methods: inIpRange - Examples of allowed Match expressions: + ◆ Supported attributes (Public NAT): destination.ip + ◆ Supported attributes (Private NAT): nexthop.hub + ◆ Supported methods (Public Nat): inIpRange + ◆ Supported operators (Public NAT): ||, == + ◆ Supported operators (Private NAT): == + + Examples of allowed Match expressions (Public NAT): ◆ 'inIpRange(destination.ip, "203.0.113.0/24")'' ◆ 'destination.ip == "203.0.113.7"' ◆ 'destination.ip == "203.0.113.7" || inIpRange(destination.ip, "203.0.113.16/25")' + Example of allowed Match expression (Private NAT): + ◆ nexthop.hub == + "//networkconnectivity.googleapis.com/projects/p1/locations/global/hubs/h1" + --region=REGION Region of the NAT containing the Rule to update. If not specified, you might be prompted to select a region (interactive mode only). @@ -72,14 +82,24 @@ OPTIONAL FLAGS CLOUDSDK_COMPUTE_REGION. --source-nat-active-ips=IP_ADDRESS,[IP_ADDRESS,...] - External IP Addresses to use for connections matching this rule. + External IP Addresses to use for connections matching this rule. This + flag is supported only for Public NAT and is required when creating a + Public NAT gateway. - These must be valid reserved external IPs in the same region. + These must be valid reserved external IP addresses in the same region. + + --source-nat-active-ranges=SUBNETWORK,[SUBNETWORK,...] + Subnetworks from which addresses are used for connections matching this + rule. This flag is supported only for Private NAT and is required when + creating a Private NAT gateway. + + These must be subnetwork resources in the same region, with purpose set + to PRIVATE_NAT. At most one of these can be specified: --clear-source-nat-drain-ips - Clear drained IPs from the Rule + Clear drained IPs from the rule --source-nat-drain-ips=IP_ADDRESS,[IP_ADDRESS,...] External IP Addresses to drain connections on. @@ -87,6 +107,17 @@ OPTIONAL FLAGS These must be external IPs previously used as active IPs on this rule. No new connections will be established using these IPs. + At most one of these can be specified: + + --clear-source-nat-drain-ranges + Clear drained ranges from the rule + + --source-nat-drain-ranges=SUBNETWORK,[SUBNETWORK,...] + Subnetwork ranges to drain connections on. + + These must be subnetworks previously used as active ranges on this + rule. No new connections will be established using these ranges. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/compute/routers/nats/update b/gcloud/compute/routers/nats/update index a41f5494c..91472a073 100644 --- a/gcloud/compute/routers/nats/update +++ b/gcloud/compute/routers/nats/update @@ -23,7 +23,7 @@ SYNOPSIS | --tcp-transitory-idle-timeout=TCP_TRANSITORY_IDLE_TIMEOUT] [--clear-udp-idle-timeout | --udp-idle-timeout=UDP_IDLE_TIMEOUT] [--nat-all-subnet-ip-ranges - | --nat-custom-subnet-ip-ranges=SUBNETWORK[:RANGE_NAME],[...] + | --nat-custom-subnet-ip-ranges=SUBNETWORK[:RANGE_NAME|:ALL],[...] | --nat-primary-subnet-ip-ranges] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -252,10 +252,12 @@ OPTIONAL FLAGS Allow all IP ranges of all subnetworks in the region, including primary and secondary ranges, to use NAT. - --nat-custom-subnet-ip-ranges=SUBNETWORK[:RANGE_NAME],[...] + --nat-custom-subnet-ip-ranges=SUBNETWORK[:RANGE_NAME|:ALL],[...] List of subnetwork primary and secondary IP ranges to be allowed to use NAT. + ▸ SUBNETWORK:ALL - specifying a subnetwork name with ALL includes + the primary range and all secondary ranges of the subnet. ▸ SUBNETWORK - including a subnetwork name includes only the primary subnet range of the subnetwork. ▸ SUBNETWORK:RANGE_NAME - specifying a subnetwork and secondary diff --git a/gcloud/compute/security-policies/update b/gcloud/compute/security-policies/update index fdc1d7060..04af55556 100644 --- a/gcloud/compute/security-policies/update +++ b/gcloud/compute/security-policies/update @@ -11,6 +11,7 @@ SYNOPSIS [--log-level=LOG_LEVEL] [--network-ddos-protection=NETWORK_DDOS_PROTECTION] [--recaptcha-redirect-site-key=RECAPTCHA_REDIRECT_SITE_KEY] + [--user-ip-request-headers=[USER_IP_REQUEST_HEADER,...]] [--global | --region=REGION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -63,6 +64,10 @@ FLAGS The reCAPTCHA site key to be used for rules using the redirect action and the google-recaptcha redirect type under the security policy. + --user-ip-request-headers=[USER_IP_REQUEST_HEADER,...] + A comma-separated list of request header names to use for resolving the + caller's user IP address. + At most one of these can be specified: --global diff --git a/gcloud/compute/tpus/tpu-vm/update b/gcloud/compute/tpus/tpu-vm/update index a12a4b098..9de25ebae 100644 --- a/gcloud/compute/tpus/tpu-vm/update +++ b/gcloud/compute/tpus/tpu-vm/update @@ -7,7 +7,10 @@ SYNOPSIS [--internal-ips] [--update-labels=[KEY=VALUE,...]] [--attach-disk=[SOURCE=DATA_DISK,...] | --detach-disk=DATA_DISK] [--clear-labels | --remove-labels=[KEY,...]] - [--clear-tags | --remove-tags=[TAG,...]] [GCLOUD_WIDE_FLAG ...] + [--clear-tags | --remove-tags=[TAG,...]] + [--metadata-from-file=[KEY=VALUE,...] + | --update-metadata=[KEY=VALUE,...] --clear-metadata + | --remove-metadata=[KEY,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Update a Cloud TPU VM node. @@ -176,6 +179,38 @@ FLAGS ignored. If --add-tags is also specified then --add-tags is applied first. + At most one of these can be specified: + + --metadata-from-file=[KEY=VALUE,...] + Same as --metadata except the value for the entry will be read from a + local file. Example: --metadata-from-file='key1=value1.txt' + + --update-metadata=[KEY=VALUE,...] + List of comma-separated metadata key-value pairs for the Cloud TPU VM + node. If a key exists, its value is modified. Otherwise, a new + key-value pair is created. + + At most one of these can be specified: + + --clear-metadata + Remove all metadata. If --update-metadata is also specified then + --clear-metadata is applied first. + + For example, to remove all metadata: + + $ gcloud compute tpus tpu-vm update --clear-metadata + + To remove all existing metadata and create two new metadata + key-value pairs, 'foo=bar' and 'baz=qux': + + $ gcloud compute tpus tpu-vm update --clear-metadata \ + --update-metadata foo=bar,baz=qux + + --remove-metadata=[KEY,...] + List of comma-separated metadata keys to remove. If a key does not + exist it is silently ignored. If --update-metadata is also + specified then --update-metadata is applied first. + 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/config/get b/gcloud/config/get index 69e46b88d..b0bb3eb36 100644 --- a/gcloud/config/get +++ b/gcloud/config/get @@ -1059,11 +1059,6 @@ AVAILABLE PROPERTIES resources. When a location value is required but not provided, the command will fall back to this value, if set. - region - Default region to use when working with Cloud NetApp Files regions. - When a --region flag is required but not provided, the command will - fall back to this value, if set. - notebooks location Default location to use when working with Notebook resources. When diff --git a/gcloud/config/help b/gcloud/config/help index 6e0a71952..6ffc195b1 100644 --- a/gcloud/config/help +++ b/gcloud/config/help @@ -1091,11 +1091,6 @@ AVAILABLE PROPERTIES resources. When a location value is required but not provided, the command will fall back to this value, if set. - region - Default region to use when working with Cloud NetApp Files regions. - When a --region flag is required but not provided, the command will - fall back to this value, if set. - notebooks location Default location to use when working with Notebook resources. When diff --git a/gcloud/config/list b/gcloud/config/list index 6cbbb51f8..1ac4e5327 100644 --- a/gcloud/config/list +++ b/gcloud/config/list @@ -1103,11 +1103,6 @@ AVAILABLE PROPERTIES resources. When a location value is required but not provided, the command will fall back to this value, if set. - region - Default region to use when working with Cloud NetApp Files regions. - When a --region flag is required but not provided, the command will - fall back to this value, if set. - notebooks location Default location to use when working with Notebook resources. When diff --git a/gcloud/config/set b/gcloud/config/set index 9971742d8..ae8522395 100644 --- a/gcloud/config/set +++ b/gcloud/config/set @@ -1106,11 +1106,6 @@ AVAILABLE PROPERTIES resources. When a location value is required but not provided, the command will fall back to this value, if set. - region - Default region to use when working with Cloud NetApp Files regions. - When a --region flag is required but not provided, the command will - fall back to this value, if set. - notebooks location Default location to use when working with Notebook resources. When diff --git a/gcloud/config/unset b/gcloud/config/unset index ec4363af1..9cacaf9e6 100644 --- a/gcloud/config/unset +++ b/gcloud/config/unset @@ -1067,11 +1067,6 @@ AVAILABLE PROPERTIES resources. When a location value is required but not provided, the command will fall back to this value, if set. - region - Default region to use when working with Cloud NetApp Files regions. - When a --region flag is required but not provided, the command will - fall back to this value, if set. - notebooks location Default location to use when working with Notebook resources. When diff --git a/gcloud/container/attached/clusters/import b/gcloud/container/attached/clusters/import index abba4c954..9cf884968 100644 --- a/gcloud/container/attached/clusters/import +++ b/gcloud/container/attached/clusters/import @@ -9,6 +9,8 @@ SYNOPSIS (--fleet-membership=FLEET_MEMBERSHIP : --fleet-membership-location=FLEET_MEMBERSHIP_LOCATION; default="global") [--async] [--location=LOCATION] [--validate-only] + [--proxy-secret-name=PROXY_SECRET_NAME + --proxy-secret-namespace=PROXY_SECRET_NAMESPACE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -119,6 +121,22 @@ OPTIONAL FLAGS --validate-only Validate the cluster to import, but don't actually perform it. + Proxy config + + --proxy-secret-name=PROXY_SECRET_NAME + Name of the Kubernetes secret that contains the HTTP/HTTPS proxy + configuration. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --proxy-secret-namespace=PROXY_SECRET_NAMESPACE + Namespace of the Kubernetes secret that contains the HTTP/HTTPS proxy + configuration. + + This flag argument must be specified if any of the other arguments in + this group are specified. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/container/aws/node-pools/create b/gcloud/container/aws/node-pools/create index 52f000db5..226d89843 100644 --- a/gcloud/container/aws/node-pools/create +++ b/gcloud/container/aws/node-pools/create @@ -10,7 +10,9 @@ SYNOPSIS --max-pods-per-node=MAX_PODS_PER_NODE --node-version=NODE_VERSION --subnet-id=SUBNET_ID (--max-nodes=MAX_NODES --min-nodes=MIN_NODES) [--annotations=ANNOTATION,[ANNOTATION,...]] [--async] - [--enable-autorepair] [--node-labels=NODE_LABEL,[NODE_LABEL,...]] + [--enable-autorepair] [--max-surge-update=MAX_SURGE_UPDATE] + [--max-unavailable-update=MAX_UNAVAILABLE_UPDATE] + [--node-labels=NODE_LABEL,[NODE_LABEL,...]] [--node-taints=NODE_TAINT,[NODE_TAINT,...]] [--root-volume-iops=ROOT_VOLUME_IOPS] [--root-volume-kms-key-arn=ROOT_VOLUME_KMS_KEY_ARN] @@ -127,6 +129,29 @@ OPTIONAL FLAGS Node autorepair is disabled by default. + --max-surge-update=MAX_SURGE_UPDATE + Maximum number of extra (surge) nodes to be created beyond the current + size of the node pool during its update process. Use + --max-unavailable-update as well, if needed, to control the overall + surge settings. + + To create an extra node each time the node pool is rolling updated, + run: + + $ gcloud container aws node-pools create --max-surge-update=1 \ + --max-unavailable-update=0 + + --max-unavailable-update=MAX_UNAVAILABLE_UPDATE + Maximum number of nodes that can be simultaneously unavailable during + this node pool's update process. Use --max-surge-update as well, if + needed, to control the overall surge settings. + + To update 3 nodes in parallel (1 + 2), but keep at least 4 nodes (6 - + 2) available each time the node pool is rolling updated, run: + + $ gcloud container aws node-pools create --min-nodes=6 \ + --max-surge-update=1 --max-unavailable-update=2 + --node-labels=NODE_LABEL,[NODE_LABEL,...] Labels assigned to the node pool's nodes. diff --git a/gcloud/container/aws/node-pools/update b/gcloud/container/aws/node-pools/update index 11a448c29..3a6115e0f 100644 --- a/gcloud/container/aws/node-pools/update +++ b/gcloud/container/aws/node-pools/update @@ -7,8 +7,9 @@ SYNOPSIS (NODE_POOL : --cluster=CLUSTER --location=LOCATION) [--async] [--config-encryption-kms-key-arn=CONFIG_ENCRYPTION_KMS_KEY_ARN] [--enable-autorepair] [--iam-instance-profile=IAM_INSTANCE_PROFILE] - [--instance-type=INSTANCE_TYPE] [--node-version=NODE_VERSION] - [--root-volume-iops=ROOT_VOLUME_IOPS] + [--instance-type=INSTANCE_TYPE] [--max-surge-update=MAX_SURGE_UPDATE] + [--max-unavailable-update=MAX_UNAVAILABLE_UPDATE] + [--node-version=NODE_VERSION] [--root-volume-iops=ROOT_VOLUME_IOPS] [--root-volume-kms-key-arn=ROOT_VOLUME_KMS_KEY_ARN] [--root-volume-size=ROOT_VOLUME_SIZE] [--root-volume-throughput=ROOT_VOLUME_THROUGHPUT] @@ -96,6 +97,30 @@ FLAGS --instance-type=INSTANCE_TYPE AWS EC2 instance type for the node pool's nodes. + --max-surge-update=MAX_SURGE_UPDATE + Maximum number of extra (surge) nodes to be created beyond the current + size of the node pool during its update process. Use + --max-unavailable-update as well, if needed, to control the overall + surge settings. + + To create an extra node each time the node pool is rolling updated, + run: + + $ gcloud container aws node-pools update --max-surge-update=1 \ + --max-unavailable-update=0 + + --max-unavailable-update=MAX_UNAVAILABLE_UPDATE + Maximum number of nodes that can be simultaneously unavailable during + this node pool's update process. Use --max-surge-update as well, if + needed, to control the overall surge settings. + + To modify a node pool with 6 nodes such that, 3 nodes are updated in + parallel (1 + 2), but keep at least 4 nodes (6 - 2) available each time + this node pool is rolling updated, run: + + $ gcloud container aws node-pools update --max-surge-update=1 \ + --max-unavailable-update=2 + --node-version=NODE_VERSION Kubernetes version to use for the node pool. diff --git a/gcloud/container/clusters/create b/gcloud/container/clusters/create index 3a6d57d5f..667c61ea8 100644 --- a/gcloud/container/clusters/create +++ b/gcloud/container/clusters/create @@ -18,7 +18,6 @@ SYNOPSIS [--cluster-version=CLUSTER_VERSION] [--create-subnetwork=[KEY=VALUE,...]] [--database-encryption-key=DATABASE_ENCRYPTION_KEY] - [--dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE] [--default-max-pods-per-node=DEFAULT_MAX_PODS_PER_NODE] [--disable-default-snat] [--disk-size=DISK_SIZE] [--disk-type=DISK_TYPE] [--enable-autorepair] [--no-enable-autoupgrade] @@ -69,6 +68,9 @@ SYNOPSIS | --enable-binauthz] [--cluster-dns=CLUSTER_DNS --cluster-dns-domain=CLUSTER_DNS_DOMAIN --cluster-dns-scope=CLUSTER_DNS_SCOPE] + [--dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE + | --disable-dataplane-v2-flow-observability + | --enable-dataplane-v2-flow-observability] [--disable-dataplane-v2-metrics | --enable-dataplane-v2-metrics] [[--enable-autoprovisioning : --autoprovisioning-config-file=AUTOPROVISIONING_CONFIG_FILE @@ -324,35 +326,6 @@ FLAGS For more information, see https://cloud.google.com/kubernetes-engine/docs/how-to/encrypting-secrets. - --dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE - Select Advanced Datapath Observability mode for the cluster. Defaults - to DISABLED. - - Advanced Datapath Observability allows for a real-time view into - pod-to-pod traffic within your cluster. - - Examples: - - $ gcloud container clusters create \ - --dataplane-v2-observability-mode=DISABLED - - $ gcloud container clusters create \ - --dataplane-v2-observability-mode=INTERNAL_VPC_LB - - $ gcloud container clusters create \ - --dataplane-v2-observability-mode=EXTERNAL_LB - - DATAPLANE_V2_OBSERVABILITY_MODE must be one of: - - DISABLED - Disables Advanced Datapath Observability. - EXTERNAL_LB - Makes Advanced Datapath Observability available to the external - network. - INTERNAL_VPC_LB - Makes Advanced Datapath Observability available from the VPC - network. - --default-max-pods-per-node=DEFAULT_MAX_PODS_PER_NODE The default max number of pods per node for node pools in the cluster. @@ -1178,8 +1151,8 @@ FLAGS --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE Enable Binary Authorization for this cluster. - BINAUTHZ_EVALUATION_MODE must be one of: DISABLED, - PROJECT_SINGLETON_POLICY_ENFORCE. + BINAUTHZ_EVALUATION_MODE must be one of: disabled, + project-singleton-policy-enforce. --enable-binauthz (DEPRECATED) Enable Binary Authorization for this cluster. @@ -1216,6 +1189,44 @@ FLAGS vpc Configures the Cloud DNS zone to be private to the VPC Network. + At most one of these can be specified: + + --dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE + Select Advanced Datapath Observability mode for the cluster. Defaults + to DISABLED. + + Advanced Datapath Observability allows for a real-time view into + pod-to-pod traffic within your cluster. + + Examples: + + $ gcloud container clusters create \ + --dataplane-v2-observability-mode=DISABLED + + $ gcloud container clusters create \ + --dataplane-v2-observability-mode=INTERNAL_VPC_LB + + $ gcloud container clusters create \ + --dataplane-v2-observability-mode=EXTERNAL_LB + + DATAPLANE_V2_OBSERVABILITY_MODE must be one of: + + DISABLED + Disables Advanced Datapath Observability. + EXTERNAL_LB + Makes Advanced Datapath Observability available to the external + network. + INTERNAL_VPC_LB + Makes Advanced Datapath Observability available from the VPC + network. + + --disable-dataplane-v2-flow-observability + Disables Advanced Datapath Observability. + + --enable-dataplane-v2-flow-observability + Enables Advanced Datapath Observability which allows for a real-time + view into pod-to-pod traffic within your cluster. + At most one of these can be specified: --disable-dataplane-v2-metrics diff --git a/gcloud/container/clusters/create-auto b/gcloud/container/clusters/create-auto index 693d3a934..c68bf52fa 100644 --- a/gcloud/container/clusters/create-auto +++ b/gcloud/container/clusters/create-auto @@ -12,7 +12,6 @@ SYNOPSIS [--cluster-version=CLUSTER_VERSION] [--create-subnetwork=[KEY=VALUE,...]] [--database-encryption-key=DATABASE_ENCRYPTION_KEY] - [--dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE] [--enable-backup-restore] [--enable-fleet] [--enable-google-cloud-access] [--enable-kubernetes-unstable-apis=API,[API,...]] @@ -24,6 +23,9 @@ SYNOPSIS [--services-ipv4-cidr=CIDR] [--services-secondary-range-name=NAME] [--subnetwork=SUBNETWORK] [--workload-policies=WORKLOAD_POLICIES] [--workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING] + [--dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE + | --disable-dataplane-v2-flow-observability + | --enable-dataplane-v2-flow-observability] [--enable-master-authorized-networks --master-authorized-networks=NETWORK,[NETWORK,...]] [--enable-private-endpoint @@ -74,8 +76,8 @@ FLAGS --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE Enable Binary Authorization for this cluster. - BINAUTHZ_EVALUATION_MODE must be one of: DISABLED, - PROJECT_SINGLETON_POLICY_ENFORCE. + BINAUTHZ_EVALUATION_MODE must be one of: disabled, + project-singleton-policy-enforce. --boot-disk-kms-key=BOOT_DISK_KMS_KEY The Customer Managed Encryption Key used to encrypt the boot disk @@ -163,35 +165,6 @@ FLAGS For more information, see https://cloud.google.com/kubernetes-engine/docs/how-to/encrypting-secrets. - --dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE - Select Advanced Datapath Observability mode for the cluster. Defaults - to DISABLED. - - Advanced Datapath Observability allows for a real-time view into - pod-to-pod traffic within your cluster. - - Examples: - - $ gcloud container clusters create-auto \ - --dataplane-v2-observability-mode=DISABLED - - $ gcloud container clusters create-auto \ - --dataplane-v2-observability-mode=INTERNAL_VPC_LB - - $ gcloud container clusters create-auto \ - --dataplane-v2-observability-mode=EXTERNAL_LB - - DATAPLANE_V2_OBSERVABILITY_MODE must be one of: - - DISABLED - Disables Advanced Datapath Observability. - EXTERNAL_LB - Makes Advanced Datapath Observability available to the external - network. - INTERNAL_VPC_LB - Makes Advanced Datapath Observability available from the VPC - network. - --enable-backup-restore Enable the Backup for GKE add-on. This add-on is disabled by default. To learn more, see the Backup for GKE overview: @@ -377,6 +350,44 @@ FLAGS WORKLOAD_VULNERABILITY_SCANNING must be one of: disabled, standard. + At most one of these can be specified: + + --dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE + Select Advanced Datapath Observability mode for the cluster. Defaults + to DISABLED. + + Advanced Datapath Observability allows for a real-time view into + pod-to-pod traffic within your cluster. + + Examples: + + $ gcloud container clusters create-auto \ + --dataplane-v2-observability-mode=DISABLED + + $ gcloud container clusters create-auto \ + --dataplane-v2-observability-mode=INTERNAL_VPC_LB + + $ gcloud container clusters create-auto \ + --dataplane-v2-observability-mode=EXTERNAL_LB + + DATAPLANE_V2_OBSERVABILITY_MODE must be one of: + + DISABLED + Disables Advanced Datapath Observability. + EXTERNAL_LB + Makes Advanced Datapath Observability available to the external + network. + INTERNAL_VPC_LB + Makes Advanced Datapath Observability available from the VPC + network. + + --disable-dataplane-v2-flow-observability + Disables Advanced Datapath Observability. + + --enable-dataplane-v2-flow-observability + Enables Advanced Datapath Observability which allows for a real-time + view into pod-to-pod traffic within your cluster. + Master Authorized Networks --enable-master-authorized-networks diff --git a/gcloud/container/clusters/update b/gcloud/container/clusters/update index 2efd05fbd..b212ec63e 100644 --- a/gcloud/container/clusters/update +++ b/gcloud/container/clusters/update @@ -56,6 +56,8 @@ SYNOPSIS | --cluster-dns=CLUSTER_DNS --cluster-dns-domain=CLUSTER_DNS_DOMAIN --cluster-dns-scope=CLUSTER_DNS_SCOPE | --dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE + | --disable-dataplane-v2-flow-observability + | --enable-dataplane-v2-flow-observability --disable-dataplane-v2-metrics | --enable-dataplane-v2-metrics | [--enable-autoprovisioning : --autoprovisioning-config-file=AUTOPROVISIONING_CONFIG_FILE @@ -637,8 +639,8 @@ REQUIRED FLAGS --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE Enable Binary Authorization for this cluster. - BINAUTHZ_EVALUATION_MODE must be one of: DISABLED, - PROJECT_SINGLETON_POLICY_ENFORCE. + BINAUTHZ_EVALUATION_MODE must be one of: disabled, + project-singleton-policy-enforce. --enable-binauthz (DEPRECATED) Enable Binary Authorization for this cluster. @@ -811,34 +813,43 @@ REQUIRED FLAGS vpc Configures the Cloud DNS zone to be private to the VPC Network. - --dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE - Select Advanced Datapath Observability mode for the cluster. Defaults - to DISABLED. + At most one of these can be specified: - Advanced Datapath Observability allows for a real-time view into - pod-to-pod traffic within your cluster. + --dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE + Select Advanced Datapath Observability mode for the cluster. + Defaults to DISABLED. - Examples: + Advanced Datapath Observability allows for a real-time view into + pod-to-pod traffic within your cluster. - $ gcloud container clusters update \ - --dataplane-v2-observability-mode=DISABLED + Examples: - $ gcloud container clusters update \ - --dataplane-v2-observability-mode=INTERNAL_VPC_LB + $ gcloud container clusters update \ + --dataplane-v2-observability-mode=DISABLED - $ gcloud container clusters update \ - --dataplane-v2-observability-mode=EXTERNAL_LB + $ gcloud container clusters update \ + --dataplane-v2-observability-mode=INTERNAL_VPC_LB - DATAPLANE_V2_OBSERVABILITY_MODE must be one of: + $ gcloud container clusters update \ + --dataplane-v2-observability-mode=EXTERNAL_LB - DISABLED - Disables Advanced Datapath Observability. - EXTERNAL_LB - Makes Advanced Datapath Observability available to the external - network. - INTERNAL_VPC_LB - Makes Advanced Datapath Observability available from the VPC - network. + DATAPLANE_V2_OBSERVABILITY_MODE must be one of: + + DISABLED + Disables Advanced Datapath Observability. + EXTERNAL_LB + Makes Advanced Datapath Observability available to the external + network. + INTERNAL_VPC_LB + Makes Advanced Datapath Observability available from the VPC + network. + + --disable-dataplane-v2-flow-observability + Disables Advanced Datapath Observability. + + --enable-dataplane-v2-flow-observability + Enables Advanced Datapath Observability which allows for a + real-time view into pod-to-pod traffic within your cluster. At most one of these can be specified: diff --git a/gcloud/container/fleet/create b/gcloud/container/fleet/create index 1520503ff..e6fc51443 100644 --- a/gcloud/container/fleet/create +++ b/gcloud/container/fleet/create @@ -4,7 +4,9 @@ NAME SYNOPSIS gcloud container fleet create [--async] [--display-name=DISPLAY_NAME] [--labels=[KEY=VALUE,...]] - [--security-posture=SECURITY_POSTURE + [--binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE + --binauthz-policy-bindings=[name=BINAUTHZ_POLICY,...] + --security-posture=SECURITY_POSTURE --workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING] [GCLOUD_WIDE_FLAG ...] @@ -41,6 +43,22 @@ FLAGS Default cluster configurations to apply across the fleet. + Binary Authorization config. + + --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE + Configure binary authorization mode for clusters to onboard the + fleet, + + $ gcloud container fleet create \ + --binauthz-evaluation-mode=POLICY_BINDINGS + + BINAUTHZ_EVALUATION_MODE must be one of: DISABLED, POLICY_BINDINGS. + + --binauthz-policy-bindings=[name=BINAUTHZ_POLICY,...] + The relative resource name of the Binary Authorization policy to + audit and/or enforce. GKE policies have the following format: + projects/{project_number}/platforms/gke/policies/{policy_id}. + Security posture config. --security-posture=SECURITY_POSTURE diff --git a/gcloud/container/fleet/dataplane-v2-encryption/describe b/gcloud/container/fleet/dataplane-v2-encryption/describe new file mode 100644 index 000000000..afe2b5772 --- /dev/null +++ b/gcloud/container/fleet/dataplane-v2-encryption/describe @@ -0,0 +1,32 @@ +NAME + gcloud container fleet dataplane-v2-encryption describe - describes the + status of the Dataplane V2 Encryption Feature resource + +SYNOPSIS + gcloud container fleet dataplane-v2-encryption describe + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + This command gets the detailed status of the Dataplane V2 Encryption + Feature in a fleet. + +EXAMPLES + To describe the Dataplane V2 Encryption Feature, run: + + $ gcloud container fleet dataplane-v2-encryption describe + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container fleet dataplane-v2-encryption describe + + $ gcloud beta container fleet dataplane-v2-encryption describe + diff --git a/gcloud/container/fleet/dataplane-v2-encryption/disable b/gcloud/container/fleet/dataplane-v2-encryption/disable new file mode 100644 index 000000000..6775f19d4 --- /dev/null +++ b/gcloud/container/fleet/dataplane-v2-encryption/disable @@ -0,0 +1,36 @@ +NAME + gcloud container fleet dataplane-v2-encryption disable - disables the + Dataplane V2 Encryption Feature + +SYNOPSIS + gcloud container fleet dataplane-v2-encryption disable [--force] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + This command disables the Dataplane V2 Encryption Feature in a fleet. + +EXAMPLES + To disable the Dataplane V2 Encryption Feature, run: + + $ gcloud container fleet dataplane-v2-encryption disable + +FLAGS + --force + Disable this feature, even if it is currently in use. Force disablement + may result in unexpected behavior. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container fleet dataplane-v2-encryption disable + + $ gcloud beta container fleet dataplane-v2-encryption disable + diff --git a/gcloud/container/fleet/dataplane-v2-encryption/enable b/gcloud/container/fleet/dataplane-v2-encryption/enable new file mode 100644 index 000000000..ef796b861 --- /dev/null +++ b/gcloud/container/fleet/dataplane-v2-encryption/enable @@ -0,0 +1,31 @@ +NAME + gcloud container fleet dataplane-v2-encryption enable - enables the + Dataplane V2 Encryption Feature + +SYNOPSIS + gcloud container fleet dataplane-v2-encryption enable + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + This command enables the Dataplane V2 Encryption Feature in a fleet. + +EXAMPLES + To enable the Dataplane V2 Encryption Feature, run: + + $ gcloud container fleet dataplane-v2-encryption enable + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container fleet dataplane-v2-encryption enable + + $ gcloud beta container fleet dataplane-v2-encryption enable + diff --git a/gcloud/container/fleet/dataplane-v2-encryption/help b/gcloud/container/fleet/dataplane-v2-encryption/help new file mode 100644 index 000000000..674a3f0be --- /dev/null +++ b/gcloud/container/fleet/dataplane-v2-encryption/help @@ -0,0 +1,35 @@ +NAME + gcloud container fleet dataplane-v2-encryption - manage Dataplane V2 + Encryption Feature + +SYNOPSIS + gcloud container fleet dataplane-v2-encryption COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Dataplane V2 Encryption Feature. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + Describes the status of the Dataplane V2 Encryption Feature resource. + + disable + Disables the Dataplane V2 Encryption Feature. + + enable + Enables the Dataplane V2 Encryption Feature. + +NOTES + These variants are also available: + + $ gcloud alpha container fleet dataplane-v2-encryption + + $ gcloud beta container fleet dataplane-v2-encryption + diff --git a/gcloud/container/fleet/help b/gcloud/container/fleet/help index 35c11b46b..dad75f58b 100644 --- a/gcloud/container/fleet/help +++ b/gcloud/container/fleet/help @@ -48,6 +48,9 @@ GROUPS cloudrun Manage the CloudRun feature. + dataplane-v2-encryption + Manage Dataplane V2 Encryption Feature. + features Manage Hub Feature resources. diff --git a/gcloud/container/fleet/policycontroller/deployment/remove b/gcloud/container/fleet/policycontroller/deployment/remove index 8f115c7f1..f0894f906 100644 --- a/gcloud/container/fleet/policycontroller/deployment/remove +++ b/gcloud/container/fleet/policycontroller/deployment/remove @@ -64,6 +64,11 @@ EXAMPLES $ gcloud container fleet policycontroller deployment remove audit \ cpu-request + To remove the anti-affinity configuration: + + $ gcloud container fleet policycontroller deployment remove \ + admission pod-affinity + POSITIONAL ARGUMENTS DEPLOYMENT The PolicyController deployment component (i.e, "admission", "audit" or diff --git a/gcloud/container/fleet/policycontroller/deployment/set b/gcloud/container/fleet/policycontroller/deployment/set index 5e70ffb1d..349b4c2ed 100644 --- a/gcloud/container/fleet/policycontroller/deployment/set +++ b/gcloud/container/fleet/policycontroller/deployment/set @@ -72,6 +72,12 @@ EXAMPLES $ gcloud container fleet policycontroller deployment set audit \ cpu-request 250m + To set anti-affinity to achieve high availability on the mutation + deployment: + + $ gcloud container fleet policycontroller deployment set mutation \ + pod-affinity anti + POSITIONAL ARGUMENTS DEPLOYMENT The PolicyController deployment component (e.g. "admission", "audit" or diff --git a/gcloud/container/fleet/update b/gcloud/container/fleet/update index dec1e2079..1625cc1ad 100644 --- a/gcloud/container/fleet/update +++ b/gcloud/container/fleet/update @@ -4,7 +4,9 @@ NAME SYNOPSIS gcloud container fleet update [--async] [--display-name=DISPLAY_NAME] [--update-labels=[KEY=VALUE,...]] - [--security-posture=SECURITY_POSTURE + [--binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE + --binauthz-policy-bindings=[name=BINAUTHZ_POLICY,...] + --security-posture=SECURITY_POSTURE --workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] @@ -42,6 +44,22 @@ FLAGS Default cluster configurations to apply across the fleet. + Binary Authorization config. + + --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE + Configure binary authorization mode for clusters to onboard the + fleet, + + $ gcloud container fleet update \ + --binauthz-evaluation-mode=POLICY_BINDINGS + + BINAUTHZ_EVALUATION_MODE must be one of: DISABLED, POLICY_BINDINGS. + + --binauthz-policy-bindings=[name=BINAUTHZ_POLICY,...] + The relative resource name of the Binary Authorization policy to + audit and/or enforce. GKE policies have the following format: + projects/{project_number}/platforms/gke/policies/{policy_id}. + Security posture config. --security-posture=SECURITY_POSTURE diff --git a/gcloud/container/hub/create b/gcloud/container/hub/create index 704275d40..8038566e6 100644 --- a/gcloud/container/hub/create +++ b/gcloud/container/hub/create @@ -4,7 +4,9 @@ NAME SYNOPSIS gcloud container hub create [--async] [--display-name=DISPLAY_NAME] [--labels=[KEY=VALUE,...]] - [--security-posture=SECURITY_POSTURE + [--binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE + --binauthz-policy-bindings=[name=BINAUTHZ_POLICY,...] + --security-posture=SECURITY_POSTURE --workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING] [GCLOUD_WIDE_FLAG ...] @@ -41,6 +43,22 @@ FLAGS Default cluster configurations to apply across the fleet. + Binary Authorization config. + + --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE + Configure binary authorization mode for clusters to onboard the + fleet, + + $ gcloud container hub create \ + --binauthz-evaluation-mode=POLICY_BINDINGS + + BINAUTHZ_EVALUATION_MODE must be one of: DISABLED, POLICY_BINDINGS. + + --binauthz-policy-bindings=[name=BINAUTHZ_POLICY,...] + The relative resource name of the Binary Authorization policy to + audit and/or enforce. GKE policies have the following format: + projects/{project_number}/platforms/gke/policies/{policy_id}. + Security posture config. --security-posture=SECURITY_POSTURE diff --git a/gcloud/container/hub/dataplane-v2-encryption/describe b/gcloud/container/hub/dataplane-v2-encryption/describe new file mode 100644 index 000000000..a3b483ca3 --- /dev/null +++ b/gcloud/container/hub/dataplane-v2-encryption/describe @@ -0,0 +1,32 @@ +NAME + gcloud container hub dataplane-v2-encryption describe - describes the + status of the Dataplane V2 Encryption Feature resource + +SYNOPSIS + gcloud container hub dataplane-v2-encryption describe + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + This command gets the detailed status of the Dataplane V2 Encryption + Feature in a fleet. + +EXAMPLES + To describe the Dataplane V2 Encryption Feature, run: + + $ gcloud container hub dataplane-v2-encryption describe + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container hub dataplane-v2-encryption describe + + $ gcloud beta container hub dataplane-v2-encryption describe + diff --git a/gcloud/container/hub/dataplane-v2-encryption/disable b/gcloud/container/hub/dataplane-v2-encryption/disable new file mode 100644 index 000000000..258d567e2 --- /dev/null +++ b/gcloud/container/hub/dataplane-v2-encryption/disable @@ -0,0 +1,36 @@ +NAME + gcloud container hub dataplane-v2-encryption disable - disables the + Dataplane V2 Encryption Feature + +SYNOPSIS + gcloud container hub dataplane-v2-encryption disable [--force] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + This command disables the Dataplane V2 Encryption Feature in a fleet. + +EXAMPLES + To disable the Dataplane V2 Encryption Feature, run: + + $ gcloud container hub dataplane-v2-encryption disable + +FLAGS + --force + Disable this feature, even if it is currently in use. Force disablement + may result in unexpected behavior. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container hub dataplane-v2-encryption disable + + $ gcloud beta container hub dataplane-v2-encryption disable + diff --git a/gcloud/container/hub/dataplane-v2-encryption/enable b/gcloud/container/hub/dataplane-v2-encryption/enable new file mode 100644 index 000000000..6ef82f564 --- /dev/null +++ b/gcloud/container/hub/dataplane-v2-encryption/enable @@ -0,0 +1,30 @@ +NAME + gcloud container hub dataplane-v2-encryption enable - enables the Dataplane + V2 Encryption Feature + +SYNOPSIS + gcloud container hub dataplane-v2-encryption enable [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + This command enables the Dataplane V2 Encryption Feature in a fleet. + +EXAMPLES + To enable the Dataplane V2 Encryption Feature, run: + + $ gcloud container hub dataplane-v2-encryption enable + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container hub dataplane-v2-encryption enable + + $ gcloud beta container hub dataplane-v2-encryption enable + diff --git a/gcloud/container/hub/dataplane-v2-encryption/help b/gcloud/container/hub/dataplane-v2-encryption/help new file mode 100644 index 000000000..149d81c79 --- /dev/null +++ b/gcloud/container/hub/dataplane-v2-encryption/help @@ -0,0 +1,34 @@ +NAME + gcloud container hub dataplane-v2-encryption - manage Dataplane V2 + Encryption Feature + +SYNOPSIS + gcloud container hub dataplane-v2-encryption COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Dataplane V2 Encryption Feature. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + Describes the status of the Dataplane V2 Encryption Feature resource. + + disable + Disables the Dataplane V2 Encryption Feature. + + enable + Enables the Dataplane V2 Encryption Feature. + +NOTES + These variants are also available: + + $ gcloud alpha container hub dataplane-v2-encryption + + $ gcloud beta container hub dataplane-v2-encryption + diff --git a/gcloud/container/hub/help b/gcloud/container/hub/help index f8ab4d901..78fe138d9 100644 --- a/gcloud/container/hub/help +++ b/gcloud/container/hub/help @@ -48,6 +48,9 @@ GROUPS cloudrun Manage the CloudRun feature. + dataplane-v2-encryption + Manage Dataplane V2 Encryption Feature. + features Manage Hub Feature resources. diff --git a/gcloud/container/hub/policycontroller/deployment/remove b/gcloud/container/hub/policycontroller/deployment/remove index 96d525d95..a7506489b 100644 --- a/gcloud/container/hub/policycontroller/deployment/remove +++ b/gcloud/container/hub/policycontroller/deployment/remove @@ -64,6 +64,11 @@ EXAMPLES $ gcloud container hub policycontroller deployment remove audit \ cpu-request + To remove the anti-affinity configuration: + + $ gcloud container hub policycontroller deployment remove \ + admission pod-affinity + POSITIONAL ARGUMENTS DEPLOYMENT The PolicyController deployment component (i.e, "admission", "audit" or diff --git a/gcloud/container/hub/policycontroller/deployment/set b/gcloud/container/hub/policycontroller/deployment/set index a9a850ae9..f06f40e73 100644 --- a/gcloud/container/hub/policycontroller/deployment/set +++ b/gcloud/container/hub/policycontroller/deployment/set @@ -72,6 +72,12 @@ EXAMPLES $ gcloud container hub policycontroller deployment set audit \ cpu-request 250m + To set anti-affinity to achieve high availability on the mutation + deployment: + + $ gcloud container hub policycontroller deployment set mutation \ + pod-affinity anti + POSITIONAL ARGUMENTS DEPLOYMENT The PolicyController deployment component (e.g. "admission", "audit" or diff --git a/gcloud/container/hub/update b/gcloud/container/hub/update index ebf374c2b..226016610 100644 --- a/gcloud/container/hub/update +++ b/gcloud/container/hub/update @@ -4,7 +4,9 @@ NAME SYNOPSIS gcloud container hub update [--async] [--display-name=DISPLAY_NAME] [--update-labels=[KEY=VALUE,...]] - [--security-posture=SECURITY_POSTURE + [--binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE + --binauthz-policy-bindings=[name=BINAUTHZ_POLICY,...] + --security-posture=SECURITY_POSTURE --workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] @@ -42,6 +44,22 @@ FLAGS Default cluster configurations to apply across the fleet. + Binary Authorization config. + + --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE + Configure binary authorization mode for clusters to onboard the + fleet, + + $ gcloud container hub update \ + --binauthz-evaluation-mode=POLICY_BINDINGS + + BINAUTHZ_EVALUATION_MODE must be one of: DISABLED, POLICY_BINDINGS. + + --binauthz-policy-bindings=[name=BINAUTHZ_POLICY,...] + The relative resource name of the Binary Authorization policy to + audit and/or enforce. GKE policies have the following format: + projects/{project_number}/platforms/gke/policies/{policy_id}. + Security posture config. --security-posture=SECURITY_POSTURE diff --git a/gcloud/database-migration/connection-profiles/create/alloydb b/gcloud/database-migration/connection-profiles/create/alloydb index 5601fa01a..0d77a1da7 100644 --- a/gcloud/database-migration/connection-profiles/create/alloydb +++ b/gcloud/database-migration/connection-profiles/create/alloydb @@ -7,8 +7,9 @@ SYNOPSIS (CONNECTION_PROFILE : --region=REGION) --cpu-count=CPU_COUNT --password=PASSWORD --primary-id=PRIMARY_ID [--no-async] [--cluster-labels=[KEY=VALUE,...]] [--database-flags=[FLAG=VALUE,...]] - [--display-name=DISPLAY_NAME] [--labels=[KEY=VALUE,...]] - [--network=NETWORK] [--primary-labels=[KEY=VALUE,...]] + [--database-version=DATABASE_VERSION] [--display-name=DISPLAY_NAME] + [--labels=[KEY=VALUE,...]] [--network=NETWORK] + [--primary-labels=[KEY=VALUE,...]] [--kms-key=KMS_KEY : --kms-keyring=KMS_KEYRING --kms-project=KMS_PROJECT] [GCLOUD_WIDE_FLAG ...] @@ -85,6 +86,10 @@ OPTIONAL FLAGS AlloyDB's documentation for allowed flags (e.g., --database-flags max_allowed_packet=55555,skip_grant_tables=,log_output=1). + --database-version=DATABASE_VERSION + Database engine major version. DATABASE_VERSION must be one of: + POSTGRES_14, POSTGRES_15. + --display-name=DISPLAY_NAME A user-friendly name for the connection profile. The display name can include letters, numbers, spaces, and hyphens, and must start with a diff --git a/gcloud/database-migration/conversion-workspaces/apply b/gcloud/database-migration/conversion-workspaces/apply index a6bfb39d4..743c5c371 100644 --- a/gcloud/database-migration/conversion-workspaces/apply +++ b/gcloud/database-migration/conversion-workspaces/apply @@ -87,7 +87,7 @@ OPTIONAL FLAGS Filter the entities based on (AIP-160)[https://google.aip.dev/160] standard. Example: to filter all tables whose name start with "Employee" and are present under schema "Company", use filter as - "parent = Company and TABLE=Employee" + "Company.Employee* AND type=TABLE" GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/database-migration/conversion-workspaces/convert b/gcloud/database-migration/conversion-workspaces/convert index b45d24018..59b6786d7 100644 --- a/gcloud/database-migration/conversion-workspaces/convert +++ b/gcloud/database-migration/conversion-workspaces/convert @@ -59,7 +59,7 @@ FLAGS Filter the entities based on (AIP-160)[https://google.aip.dev/160] standard. Example: to filter all tables whose name start with "Employee" and are present under schema "Company", use filter as - "parent = Company and TABLE=Employee" + "Company.Employee* AND type=TABLE" GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/database-migration/conversion-workspaces/describe-ddls b/gcloud/database-migration/conversion-workspaces/describe-ddls index 9b8a4b4bf..1d152da9c 100644 --- a/gcloud/database-migration/conversion-workspaces/describe-ddls +++ b/gcloud/database-migration/conversion-workspaces/describe-ddls @@ -65,7 +65,7 @@ FLAGS Filter the entities based on (AIP-160)[https://google.aip.dev/160] standard. Example: to filter all tables whose name start with "Employee" and are present under schema "Company", use filter as - "parent = Company and TABLE=Employee" + "Company.Employee* AND type=TABLE" --tree-type=TREE_TYPE; default="DRAFT" Tree type for database entities. TREE_TYPE must be one of: SOURCE, diff --git a/gcloud/database-migration/conversion-workspaces/describe-entities b/gcloud/database-migration/conversion-workspaces/describe-entities index 3003eb637..05a8ae96c 100644 --- a/gcloud/database-migration/conversion-workspaces/describe-entities +++ b/gcloud/database-migration/conversion-workspaces/describe-entities @@ -65,7 +65,7 @@ OPTIONAL FLAGS Filter the entities based on (AIP-160)[https://google.aip.dev/160] standard. Example: to filter all tables whose name start with "Employee" and are present under schema "Company", use filter as - "parent = Company and TABLE=Employee" + "Company.Employee* AND type=TABLE" --uncommitted Whether to retrieve the latest committed version of the entities or the diff --git a/gcloud/database-migration/conversion-workspaces/describe-issues b/gcloud/database-migration/conversion-workspaces/describe-issues index 9c7d7aedf..b7501eb80 100644 --- a/gcloud/database-migration/conversion-workspaces/describe-issues +++ b/gcloud/database-migration/conversion-workspaces/describe-issues @@ -59,7 +59,7 @@ FLAGS Filter the entities based on (AIP-160)[https://google.aip.dev/160] standard. Example: to filter all tables whose name start with "Employee" and are present under schema "Company", use filter as - "parent = Company and TABLE=Employee" + "Company.Employee* AND type=TABLE" --uncommitted Whether to retrieve the latest committed version of the entities or the diff --git a/gcloud/database-migration/migration-jobs/create b/gcloud/database-migration/migration-jobs/create index e66907df5..8896f88d0 100644 --- a/gcloud/database-migration/migration-jobs/create +++ b/gcloud/database-migration/migration-jobs/create @@ -191,7 +191,7 @@ OPTIONAL FLAGS Filter the entities based on (AIP-160)[https://google.aip.dev/160] standard. Example: to filter all tables whose name start with "Employee" and are present under schema "Company", use filter as - "parent = Company and TABLE=Employee" + "Company.Employee* AND type=TABLE" --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. diff --git a/gcloud/domains/registrations/configure/management b/gcloud/domains/registrations/configure/management index 659e93ef8..1957aef40 100644 --- a/gcloud/domains/registrations/configure/management +++ b/gcloud/domains/registrations/configure/management @@ -4,6 +4,7 @@ NAME SYNOPSIS gcloud domains registrations configure management REGISTRATION [--async] + [--preferred-renewal-method=PREFERRED_RENEWAL_METHOD] [--transfer-lock-state=TRANSFER_LOCK_STATE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -11,11 +12,21 @@ DESCRIPTION related to transfers, billing and renewals of a registration. EXAMPLES + To start an interactive flow to configure management settings for + example.com, run: + + $ gcloud domains registrations configure management example.com + To unlock a transfer lock of a registration for example.com, run: $ gcloud domains registrations configure management example.com \ --transfer-lock-state=unlocked + To disable automatic renewals for example.com, run: + + $ gcloud domains registrations configure management example.com \ + --preferred-renewal-method=renewal-disabled + POSITIONAL ARGUMENTS Registration resource - The domain registration to configure management settings for. This represents a Cloud resource. (NOTE) Some attributes are @@ -46,6 +57,17 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --preferred-renewal-method=PREFERRED_RENEWAL_METHOD + Preferred Renewal Method of a registration. It defines how the + registration should be renewed. The actual Renewal Method can be set to + renewal-disabled in case of e.g. problems with the Billing Account or + reporeted domain abuse. PREFERRED_RENEWAL_METHOD must be one of: + + automatic-renewal + The domain is automatically renewed each year. + renewal-disabled + The domain won't be renewed and will expire at its expiration time. + --transfer-lock-state=TRANSFER_LOCK_STATE Transfer Lock of a registration. It needs to be unlocked in order to transfer the domain to another registrar. TRANSFER_LOCK_STATE must be diff --git a/gcloud/filestore/instances/create b/gcloud/filestore/instances/create index b623f4a2d..7cca0482d 100644 --- a/gcloud/filestore/instances/create +++ b/gcloud/filestore/instances/create @@ -218,8 +218,7 @@ OPTIONAL FLAGS basic-ssd Performant NFS storage system using SSD. enterprise - Enterprise instances offer the features and availability needed for - mission-critical workloads. + Enterprise instance. Use REGIONAL instead whenever possible. high-scale-ssd High Scale SSD instance, an alias for ZONAL. Use ZONAL instead whenever possible. diff --git a/gcloud/healthcare/hl7v2-stores/help b/gcloud/healthcare/hl7v2-stores/help index 147db1886..5ccdf535d 100644 --- a/gcloud/healthcare/hl7v2-stores/help +++ b/gcloud/healthcare/hl7v2-stores/help @@ -42,6 +42,9 @@ COMMANDS list List Cloud Healthcare API HL7v2 stores. + metrics + Gets the metrics for a Cloud Healthcare API HL7v2 store. + remove-iam-policy-binding Remove an IAM policy binding from a Cloud Healthcare API HL7v2 store. diff --git a/gcloud/healthcare/hl7v2-stores/metrics b/gcloud/healthcare/hl7v2-stores/metrics new file mode 100644 index 000000000..bdf7a47c1 --- /dev/null +++ b/gcloud/healthcare/hl7v2-stores/metrics @@ -0,0 +1,78 @@ +NAME + gcloud healthcare hl7v2-stores metrics - gets the metrics for a Cloud + Healthcare API HL7v2 store + +SYNOPSIS + gcloud healthcare hl7v2-stores metrics + (HL7V2_STORE : --dataset=DATASET --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Gets the metrics for a Cloud Healthcare API HL7v2 store. + +EXAMPLES + To get metrics for the HL7v2 store 'test-hl7v2-store', run: + + $ gcloud healthcare hl7v2-stores metrics test-hl7v2-store \ + --dataset=test-dataset + +POSITIONAL ARGUMENTS + Hl7v2Store resource - Cloud Healthcare API HL7v2 store to get metrics 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 hl7v2_store 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. + + HL7V2_STORE + ID of the hl7v2Store or fully qualified identifier for the + hl7v2Store. + + To set the hl7v2_store attribute: + ▸ provide the argument hl7v2_store on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --dataset=DATASET + Cloud Healthcare dataset. + + To set the dataset attribute: + ▸ provide the argument hl7v2_store on the command line with a fully + specified name; + ▸ provide the argument --dataset on the command line. + + --location=LOCATION + Google Cloud location. + + To set the location attribute: + ▸ provide the argument hl7v2_store on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property healthcare/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the healthcare/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/healthcare + +NOTES + These variants are also available: + + $ gcloud alpha healthcare hl7v2-stores metrics + + $ gcloud beta healthcare hl7v2-stores metrics + diff --git a/gcloud/immersive-stream/xr/instances/create b/gcloud/immersive-stream/xr/instances/create index 2ebd91359..4a305dcf8 100644 --- a/gcloud/immersive-stream/xr/instances/create +++ b/gcloud/immersive-stream/xr/instances/create @@ -4,8 +4,11 @@ NAME SYNOPSIS gcloud immersive-stream xr instances create INSTANCE - --add-region=[capacity=CAPACITY],[region=REGION] --version=VERSION - (--content=CONTENT : --location=LOCATION) [--async] + --add-region=[autoscaling_buffer=AUTOSCALING_BUFFER], + [autoscaling_min_capacity=AUTOSCALING_MIN_CAPACITY], + [capacity=CAPACITY], + [enable_autoscaling=ENABLE_AUTOSCALING],[region=REGION] + --version=VERSION (--content=CONTENT : --location=LOCATION) [--async] [--fallback-url=FALLBACK_URL] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -38,7 +41,7 @@ POSITIONAL ARGUMENTS Name of the instance to be created REQUIRED FLAGS - --add-region=[capacity=CAPACITY],[region=REGION] + --add-region=[autoscaling_buffer=AUTOSCALING_BUFFER],[autoscaling_min_capacity=AUTOSCALING_MIN_CAPACITY],[capacity=CAPACITY],[enable_autoscaling=ENABLE_AUTOSCALING],[region=REGION] Flag used to specify region and capacity required for the service instance's availability. diff --git a/gcloud/immersive-stream/xr/instances/update b/gcloud/immersive-stream/xr/instances/update index 5e0539816..114b5be97 100644 --- a/gcloud/immersive-stream/xr/instances/update +++ b/gcloud/immersive-stream/xr/instances/update @@ -5,9 +5,15 @@ NAME SYNOPSIS gcloud immersive-stream xr instances update (INSTANCE : --location=LOCATION) - (--add-region=[capacity=CAPACITY],[region=REGION] + (--add-region=[autoscaling_buffer=AUTOSCALING_BUFFER], + [autoscaling_min_capacity=AUTOSCALING_MIN_CAPACITY], + [capacity=CAPACITY], + [enable_autoscaling=ENABLE_AUTOSCALING],[region=REGION] | --fallback-url=FALLBACK_URL | --remove-region=REMOVE_REGION - | --update-region=[capacity=CAPACITY],[region=REGION] + | --update-region=[autoscaling_buffer=AUTOSCALING_BUFFER], + [autoscaling_min_capacity=AUTOSCALING_MIN_CAPACITY], + [capacity=CAPACITY], + [enable_autoscaling=ENABLE_AUTOSCALING],[region=REGION] | --version=VERSION) [--async] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -89,7 +95,7 @@ REQUIRED FLAGS Exactly one of these must be specified: - --add-region=[capacity=CAPACITY],[region=REGION] + --add-region=[autoscaling_buffer=AUTOSCALING_BUFFER],[autoscaling_min_capacity=AUTOSCALING_MIN_CAPACITY],[capacity=CAPACITY],[enable_autoscaling=ENABLE_AUTOSCALING],[region=REGION] Flag used to specify region and capacity required for the service instance's availability. @@ -105,7 +111,7 @@ REQUIRED FLAGS --remove-region=REMOVE_REGION Region to remove - --update-region=[capacity=CAPACITY],[region=REGION] + --update-region=[autoscaling_buffer=AUTOSCALING_BUFFER],[autoscaling_min_capacity=AUTOSCALING_MIN_CAPACITY],[capacity=CAPACITY],[enable_autoscaling=ENABLE_AUTOSCALING],[region=REGION] Flag used to specify region and capacity required for the service instance's availability. diff --git a/gcloud/netapp/active-directories/create b/gcloud/netapp/active-directories/create index 2ed1a2cb7..40b6d782b 100644 --- a/gcloud/netapp/active-directories/create +++ b/gcloud/netapp/active-directories/create @@ -61,8 +61,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument active_directory on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. REQUIRED FLAGS --dns=DNS diff --git a/gcloud/netapp/active-directories/delete b/gcloud/netapp/active-directories/delete index c777713a1..077ba06da 100644 --- a/gcloud/netapp/active-directories/delete +++ b/gcloud/netapp/active-directories/delete @@ -53,8 +53,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument active_directory on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async diff --git a/gcloud/netapp/active-directories/describe b/gcloud/netapp/active-directories/describe index 24ad573e7..db4abf841 100644 --- a/gcloud/netapp/active-directories/describe +++ b/gcloud/netapp/active-directories/describe @@ -47,8 +47,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument active_directory on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/netapp/active-directories/list b/gcloud/netapp/active-directories/list index b270d4a4c..177d70092 100644 --- a/gcloud/netapp/active-directories/list +++ b/gcloud/netapp/active-directories/list @@ -25,7 +25,6 @@ FLAGS specified name; ◆ uses all locations by default. with a fully specified name; ◆ set the property netapp/location with a fully specified name; - ◆ set the property netapp/region with a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. @@ -35,8 +34,7 @@ FLAGS To set the location attribute: ▸ provide the argument --location on the command line; ▸ uses all locations by default.; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/netapp/active-directories/update b/gcloud/netapp/active-directories/update index 738d6c3f0..13fa48b87 100644 --- a/gcloud/netapp/active-directories/update +++ b/gcloud/netapp/active-directories/update @@ -63,8 +63,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument active_directory on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. REQUIRED FLAGS --dns=DNS diff --git a/gcloud/netapp/kms-configs/create b/gcloud/netapp/kms-configs/create index 72cfedff9..f8b6dcfc7 100644 --- a/gcloud/netapp/kms-configs/create +++ b/gcloud/netapp/kms-configs/create @@ -52,8 +52,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument kms_config on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. REQUIRED FLAGS Kms key resource - The Cloud KMS (Key Management Service) Crypto Key that @@ -87,8 +86,7 @@ REQUIRED FLAGS specified name; ▸ provide the argument --kms-location on the command line; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. --kms-project=KMS_PROJECT The Cloud project for the kms_key. diff --git a/gcloud/netapp/kms-configs/delete b/gcloud/netapp/kms-configs/delete index ef701cb6b..75ea8f44a 100644 --- a/gcloud/netapp/kms-configs/delete +++ b/gcloud/netapp/kms-configs/delete @@ -50,8 +50,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument kms_config on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async diff --git a/gcloud/netapp/kms-configs/describe b/gcloud/netapp/kms-configs/describe index d21ecbeff..80c33991a 100644 --- a/gcloud/netapp/kms-configs/describe +++ b/gcloud/netapp/kms-configs/describe @@ -52,8 +52,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument kms_config on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/netapp/kms-configs/encrypt b/gcloud/netapp/kms-configs/encrypt index 3ffd446f8..5f17e2daf 100644 --- a/gcloud/netapp/kms-configs/encrypt +++ b/gcloud/netapp/kms-configs/encrypt @@ -48,8 +48,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument kms_config on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async diff --git a/gcloud/netapp/kms-configs/list b/gcloud/netapp/kms-configs/list index ab00eee67..491929f80 100644 --- a/gcloud/netapp/kms-configs/list +++ b/gcloud/netapp/kms-configs/list @@ -30,7 +30,6 @@ FLAGS specified name; ◆ uses all locations by default. with a fully specified name; ◆ set the property netapp/location with a fully specified name; - ◆ set the property netapp/region with a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. @@ -40,8 +39,7 @@ FLAGS To set the location attribute: ▸ provide the argument --location on the command line; ▸ uses all locations by default.; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/netapp/kms-configs/update b/gcloud/netapp/kms-configs/update index 5e850c046..a6e25500f 100644 --- a/gcloud/netapp/kms-configs/update +++ b/gcloud/netapp/kms-configs/update @@ -60,8 +60,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument kms_config on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async @@ -129,8 +128,7 @@ FLAGS specified name; ▸ provide the argument --kms-location on the command line; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. --kms-project=KMS_PROJECT The Cloud project for the kms_key. diff --git a/gcloud/netapp/kms-configs/verify b/gcloud/netapp/kms-configs/verify index 274f63291..eeddd3a90 100644 --- a/gcloud/netapp/kms-configs/verify +++ b/gcloud/netapp/kms-configs/verify @@ -47,8 +47,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument kms_config on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/netapp/operations/describe b/gcloud/netapp/operations/describe index 5a084f78e..fc944877e 100644 --- a/gcloud/netapp/operations/describe +++ b/gcloud/netapp/operations/describe @@ -44,8 +44,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument operation on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/netapp/operations/list b/gcloud/netapp/operations/list index 303b6220a..aef3dfaf6 100644 --- a/gcloud/netapp/operations/list +++ b/gcloud/netapp/operations/list @@ -24,7 +24,6 @@ FLAGS specified name; ◆ uses all locations by default. with a fully specified name; ◆ set the property netapp/location with a fully specified name; - ◆ set the property netapp/region with a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. @@ -34,8 +33,7 @@ FLAGS To set the location attribute: ▸ provide the argument --location on the command line; ▸ uses all locations by default.; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/netapp/storage-pools/create b/gcloud/netapp/storage-pools/create index 857e79be1..eadbbed53 100644 --- a/gcloud/netapp/storage-pools/create +++ b/gcloud/netapp/storage-pools/create @@ -54,8 +54,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument storage_pool on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. REQUIRED FLAGS --capacity=CAPACITY @@ -109,8 +108,7 @@ OPTIONAL FLAGS ◆ provide the argument --active-directory on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --active-directory=ACTIVE_DIRECTORY ID of the active_directory or fully qualified identifier for the @@ -144,8 +142,7 @@ OPTIONAL FLAGS ◆ provide the argument --kms-config on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --kms-config=KMS_CONFIG ID of the kms_config or fully qualified identifier for the diff --git a/gcloud/netapp/storage-pools/delete b/gcloud/netapp/storage-pools/delete index 8c8534faa..bad34db31 100644 --- a/gcloud/netapp/storage-pools/delete +++ b/gcloud/netapp/storage-pools/delete @@ -50,8 +50,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument storage_pool on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async diff --git a/gcloud/netapp/storage-pools/describe b/gcloud/netapp/storage-pools/describe index 90074377a..d0e2a8f89 100644 --- a/gcloud/netapp/storage-pools/describe +++ b/gcloud/netapp/storage-pools/describe @@ -46,8 +46,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument storage_pool on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/netapp/storage-pools/list b/gcloud/netapp/storage-pools/list index 494ff1bfb..745ddc4df 100644 --- a/gcloud/netapp/storage-pools/list +++ b/gcloud/netapp/storage-pools/list @@ -24,7 +24,6 @@ FLAGS specified name; ◆ uses all locations by default. with a fully specified name; ◆ set the property netapp/location with a fully specified name; - ◆ set the property netapp/region with a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. @@ -34,8 +33,7 @@ FLAGS To set the location attribute: ▸ provide the argument --location on the command line; ▸ uses all locations by default.; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/netapp/storage-pools/update b/gcloud/netapp/storage-pools/update index dfefc55a1..7277e1f5a 100644 --- a/gcloud/netapp/storage-pools/update +++ b/gcloud/netapp/storage-pools/update @@ -49,8 +49,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument storage_pool on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS Active directory resource - The Active Directory to attach to the Storage @@ -67,8 +66,7 @@ FLAGS ◆ provide the argument --active-directory on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --active-directory=ACTIVE_DIRECTORY ID of the active_directory or fully qualified identifier for the diff --git a/gcloud/netapp/volumes/create b/gcloud/netapp/volumes/create index 9981b0b61..d384182a2 100644 --- a/gcloud/netapp/volumes/create +++ b/gcloud/netapp/volumes/create @@ -81,8 +81,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument volume on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. REQUIRED FLAGS --capacity=CAPACITY @@ -110,8 +109,7 @@ REQUIRED FLAGS ◆ provide the argument --storage-pool on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. This must be specified. @@ -175,8 +173,10 @@ OPTIONAL FLAGS CONTINUOUSLY_AVAILABLE. --snap-reserve=SNAP_RESERVE - The percentage of volume storage reserved for snapshot storage. The - default value for this is 0 percent + (DEPRECATED) The percentage of volume storage reserved for snapshot + storage. The default value for this is 0 percent + + The snap-reserve option is deprecated --snapshot-daily=[hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP] Make a snapshot every day e.g. at 06:00, 05:20, 23:50 @@ -209,8 +209,7 @@ OPTIONAL FLAGS To set the location attribute: ◆ provide the argument --source-snapshot on the command line with a fully specified name; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. To set the volume attribute: ◆ provide the argument --source-snapshot on the command line with a diff --git a/gcloud/netapp/volumes/delete b/gcloud/netapp/volumes/delete index 44011fbb4..b2ca27047 100644 --- a/gcloud/netapp/volumes/delete +++ b/gcloud/netapp/volumes/delete @@ -46,8 +46,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument volume on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async diff --git a/gcloud/netapp/volumes/describe b/gcloud/netapp/volumes/describe index fa4dfdb31..5235768f2 100644 --- a/gcloud/netapp/volumes/describe +++ b/gcloud/netapp/volumes/describe @@ -42,8 +42,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument volume on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/netapp/volumes/list b/gcloud/netapp/volumes/list index 19ad692f5..200a9977c 100644 --- a/gcloud/netapp/volumes/list +++ b/gcloud/netapp/volumes/list @@ -24,7 +24,6 @@ FLAGS specified name; ◆ uses all locations by default. with a fully specified name; ◆ set the property netapp/location with a fully specified name; - ◆ set the property netapp/region with a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. @@ -34,8 +33,7 @@ FLAGS To set the location attribute: ▸ provide the argument --location on the command line; ▸ uses all locations by default.; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/netapp/volumes/replications/create b/gcloud/netapp/volumes/replications/create index b6b467283..8dcdde684 100644 --- a/gcloud/netapp/volumes/replications/create +++ b/gcloud/netapp/volumes/replications/create @@ -61,8 +61,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument replication on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. REQUIRED FLAGS --destination-volume-parameters=[description=DESCRIPTION],[share_name=SHARE_NAME],[storage_pool=STORAGE_POOL],[volume_id=VOLUME_ID] @@ -99,8 +98,7 @@ OPTIONAL FLAGS ◆ provide the argument --volume on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --volume=VOLUME ID of the volume or fully qualified identifier for the volume. diff --git a/gcloud/netapp/volumes/replications/delete b/gcloud/netapp/volumes/replications/delete index a904b270b..f900580a5 100644 --- a/gcloud/netapp/volumes/replications/delete +++ b/gcloud/netapp/volumes/replications/delete @@ -59,8 +59,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument replication on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async @@ -81,8 +80,7 @@ FLAGS ◆ provide the argument --volume on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --volume=VOLUME ID of the volume or fully qualified identifier for the volume. diff --git a/gcloud/netapp/volumes/replications/describe b/gcloud/netapp/volumes/replications/describe index 013b05dd9..b943846e6 100644 --- a/gcloud/netapp/volumes/replications/describe +++ b/gcloud/netapp/volumes/replications/describe @@ -53,8 +53,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument replication on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS Volume resource - The Volume that the Replication is based on This @@ -71,8 +70,7 @@ FLAGS ◆ provide the argument --volume on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --volume=VOLUME ID of the volume or fully qualified identifier for the volume. diff --git a/gcloud/netapp/volumes/replications/list b/gcloud/netapp/volumes/replications/list index ea8dddfe5..6ade67b3f 100644 --- a/gcloud/netapp/volumes/replications/list +++ b/gcloud/netapp/volumes/replications/list @@ -28,7 +28,6 @@ FLAGS specified name; ◆ uses all locations by default. with a fully specified name; ◆ set the property netapp/location with a fully specified name; - ◆ set the property netapp/region with a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. @@ -38,8 +37,7 @@ FLAGS To set the location attribute: ▸ provide the argument --location on the command line; ▸ uses all locations by default.; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. Volume resource - The Volume that the Replication is based on This represents a Cloud resource. (NOTE) Some attributes are not given @@ -55,8 +53,7 @@ FLAGS ◆ provide the argument --volume on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --volume=VOLUME ID of the volume or fully qualified identifier for the volume. diff --git a/gcloud/netapp/volumes/replications/resume b/gcloud/netapp/volumes/replications/resume index de0aa3935..a6a838217 100644 --- a/gcloud/netapp/volumes/replications/resume +++ b/gcloud/netapp/volumes/replications/resume @@ -59,8 +59,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument replication on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async @@ -81,8 +80,7 @@ FLAGS ◆ provide the argument --volume on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --volume=VOLUME ID of the volume or fully qualified identifier for the volume. diff --git a/gcloud/netapp/volumes/replications/reverse b/gcloud/netapp/volumes/replications/reverse index d31cbe70f..ed1f4879b 100644 --- a/gcloud/netapp/volumes/replications/reverse +++ b/gcloud/netapp/volumes/replications/reverse @@ -59,8 +59,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument replication on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async @@ -81,8 +80,7 @@ FLAGS ◆ provide the argument --volume on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --volume=VOLUME ID of the volume or fully qualified identifier for the volume. diff --git a/gcloud/netapp/volumes/replications/stop b/gcloud/netapp/volumes/replications/stop index 79159a064..0bdafbd60 100644 --- a/gcloud/netapp/volumes/replications/stop +++ b/gcloud/netapp/volumes/replications/stop @@ -57,8 +57,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument replication on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async @@ -86,8 +85,7 @@ FLAGS ◆ provide the argument --volume on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --volume=VOLUME ID of the volume or fully qualified identifier for the volume. diff --git a/gcloud/netapp/volumes/replications/update b/gcloud/netapp/volumes/replications/update index bd02e62c9..5cbb0e920 100644 --- a/gcloud/netapp/volumes/replications/update +++ b/gcloud/netapp/volumes/replications/update @@ -58,8 +58,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument replication on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async @@ -95,8 +94,7 @@ FLAGS ◆ provide the argument --volume on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --volume=VOLUME ID of the volume or fully qualified identifier for the volume. diff --git a/gcloud/netapp/volumes/revert b/gcloud/netapp/volumes/revert index bc18e5132..3fbae5dbb 100644 --- a/gcloud/netapp/volumes/revert +++ b/gcloud/netapp/volumes/revert @@ -45,8 +45,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument volume on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. REQUIRED FLAGS Snapshot resource - The Snapshot to revert the Volume back to. This @@ -62,8 +61,7 @@ REQUIRED FLAGS To set the location attribute: ◆ provide the argument --snapshot on the command line with a fully specified name; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. To set the volume attribute: ◆ provide the argument --snapshot on the command line with a fully diff --git a/gcloud/netapp/volumes/snapshots/create b/gcloud/netapp/volumes/snapshots/create index bb2a35332..6bca67c8b 100644 --- a/gcloud/netapp/volumes/snapshots/create +++ b/gcloud/netapp/volumes/snapshots/create @@ -52,8 +52,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument snapshot on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async @@ -85,8 +84,7 @@ FLAGS ◆ provide the argument --volume on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --volume=VOLUME ID of the volume or fully qualified identifier for the volume. diff --git a/gcloud/netapp/volumes/snapshots/delete b/gcloud/netapp/volumes/snapshots/delete index cdfbd63e8..a02105e47 100644 --- a/gcloud/netapp/volumes/snapshots/delete +++ b/gcloud/netapp/volumes/snapshots/delete @@ -56,8 +56,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument snapshot on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async @@ -78,8 +77,7 @@ FLAGS ◆ provide the argument --volume on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --volume=VOLUME ID of the volume or fully qualified identifier for the volume. diff --git a/gcloud/netapp/volumes/snapshots/describe b/gcloud/netapp/volumes/snapshots/describe index 12659eb6c..2a42030b4 100644 --- a/gcloud/netapp/volumes/snapshots/describe +++ b/gcloud/netapp/volumes/snapshots/describe @@ -51,8 +51,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument snapshot on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS Volume resource - The Volume to take a Snapshot of. This represents a @@ -69,8 +68,7 @@ FLAGS ◆ provide the argument --volume on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --volume=VOLUME ID of the volume or fully qualified identifier for the volume. diff --git a/gcloud/netapp/volumes/snapshots/list b/gcloud/netapp/volumes/snapshots/list index b22884255..3ed184b1c 100644 --- a/gcloud/netapp/volumes/snapshots/list +++ b/gcloud/netapp/volumes/snapshots/list @@ -26,7 +26,6 @@ FLAGS specified name; ◆ uses all locations by default. with a fully specified name; ◆ set the property netapp/location with a fully specified name; - ◆ set the property netapp/region with a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. @@ -36,8 +35,7 @@ FLAGS To set the location attribute: ▸ provide the argument --location on the command line; ▸ uses all locations by default.; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. Volume resource - The Volume to take a Snapshot of. This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this @@ -53,8 +51,7 @@ FLAGS ◆ provide the argument --volume on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --volume=VOLUME ID of the volume or fully qualified identifier for the volume. diff --git a/gcloud/netapp/volumes/snapshots/update b/gcloud/netapp/volumes/snapshots/update index 4eda9de46..f2651cefd 100644 --- a/gcloud/netapp/volumes/snapshots/update +++ b/gcloud/netapp/volumes/snapshots/update @@ -54,8 +54,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument snapshot on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async @@ -88,8 +87,7 @@ FLAGS ◆ provide the argument --volume on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --volume=VOLUME ID of the volume or fully qualified identifier for the volume. diff --git a/gcloud/netapp/volumes/update b/gcloud/netapp/volumes/update index 846cb8130..ba6a00560 100644 --- a/gcloud/netapp/volumes/update +++ b/gcloud/netapp/volumes/update @@ -73,8 +73,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument volume on the command line with a fully specified name; ▸ provide the argument --location on the command line; - ▸ set the property netapp/location; - ▸ set the property netapp/region. + ▸ set the property netapp/location. FLAGS --async @@ -132,8 +131,10 @@ FLAGS CONTINUOUSLY_AVAILABLE. --snap-reserve=SNAP_RESERVE - The percentage of volume storage reserved for snapshot storage. The - default value for this is 0 percent + (DEPRECATED) The percentage of volume storage reserved for snapshot + storage. The default value for this is 0 percent + + The snap-reserve option is deprecated --snapshot-daily=[hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP] Make a snapshot every day e.g. at 06:00, 05:20, 23:50 @@ -166,8 +167,7 @@ FLAGS To set the location attribute: ◆ provide the argument --source-snapshot on the command line with a fully specified name; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. To set the volume attribute: ◆ provide the argument --source-snapshot on the command line with a @@ -193,8 +193,7 @@ FLAGS ◆ provide the argument --storage-pool on the command line with a fully specified name; ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. + ◆ set the property netapp/location. --storage-pool=STORAGE_POOL ID of the storage_pool or fully qualified identifier for the diff --git a/gcloud/pubsub/topics/create b/gcloud/pubsub/topics/create index 7ce023061..79d0b6eaf 100644 --- a/gcloud/pubsub/topics/create +++ b/gcloud/pubsub/topics/create @@ -63,9 +63,11 @@ FLAGS is one of "s", "m", "h", and "d" for seconds, minutes, hours, and days, respectively. If the unit is omitted, seconds is assumed. - --message-storage-policy-allowed-regions=[REGION,...] - A list of one or more Cloud regions where messages are allowed to be - stored at rest. + Options for explicitly specifying the message storage policy for a topic. + + --message-storage-policy-allowed-regions=[REGION,...] + A list of one or more Cloud regions where messages are allowed to be + stored at rest. Schema settings. The schema that messages published to this topic must conform to and the expected message encoding. diff --git a/gcloud/pubsub/topics/update b/gcloud/pubsub/topics/update index 19b24d61e..d68e321b6 100644 --- a/gcloud/pubsub/topics/update +++ b/gcloud/pubsub/topics/update @@ -184,14 +184,18 @@ FLAGS At most one of these can be specified: - --message-storage-policy-allowed-regions=[REGION,...] - A list of one or more Cloud regions where messages are allowed to be - stored at rest. + Options for explicitly specifying the message storage policy for a + topic. These fields can be set only if the + --recompute-message-storage-policy flag is not set. + + --message-storage-policy-allowed-regions=[REGION,...] + A list of one or more Cloud regions where messages are allowed to + be stored at rest. --recompute-message-storage-policy - If given, Cloud Pub/Sub will recompute the regions where messages can - be stored at rest, based on your organization's "Resource Location - Restriction" policy. + If given, Pub/Sub recomputes the regions where messages can be stored + at rest, based on your organization's "Resource Location Restriction" + policy. Key resource - The Cloud KMS (Key Management Service) cryptokey that will be used to protect the topic. The specified Cloud KMS key should have diff --git a/gcloud/recaptcha/keys/create b/gcloud/recaptcha/keys/create index d6a154fd6..8eb22d79e 100644 --- a/gcloud/recaptcha/keys/create +++ b/gcloud/recaptcha/keys/create @@ -207,6 +207,9 @@ OPTIONAL FLAGS ca Cloud Armor + cloudflare + Cloudflare + fastly Fastly diff --git a/gcloud/recommender/insights/list b/gcloud/recommender/insights/list index fc4cc9efa..130e76d04 100644 --- a/gcloud/recommender/insights/list +++ b/gcloud/recommender/insights/list @@ -19,7 +19,7 @@ DESCRIPTION EXAMPLES To list all insights for a billing account: - $ gcloud recommender insights list --project=project-name \ + $ gcloud recommender insights list --project=project-id \ --location=global --insight-type=google.compute.firewall.Insight REQUIRED FLAGS @@ -28,7 +28,7 @@ REQUIRED FLAGS here: https://cloud.google.com/recommender/docs/insights/insight-types --location=LOCATION - Location + Location to list insights for. Resource that is associated with cloud entity type. Currently four mutually exclusive flags are supported, --project, --billing-account, diff --git a/gcloud/recommender/insights/mark-accepted b/gcloud/recommender/insights/mark-accepted index 29f740d6a..e59806e4d 100644 --- a/gcloud/recommender/insights/mark-accepted +++ b/gcloud/recommender/insights/mark-accepted @@ -18,7 +18,7 @@ EXAMPLES To mark an insight as ACCEPTED: $ gcloud recommender insights mark-accepted abcd-1234 \ - --project=project-name --location=global \ + --project=project-id --location=global \ --insight-type=google.compute.firewall.Insight --etag=abc123 POSITIONAL ARGUMENTS diff --git a/gcloud/recommender/recommendations/list b/gcloud/recommender/recommendations/list index 5b780e56e..7a8ecd3ae 100644 --- a/gcloud/recommender/recommendations/list +++ b/gcloud/recommender/recommendations/list @@ -12,19 +12,19 @@ SYNOPSIS DESCRIPTION This command lists all recommendations for a given cloud_entity_id, - location and recommender. Supported recommenders can be found here: + location, and recommender. Supported recommenders can be found here: https://cloud.google.com/recommender/docs/recommenders. Currently the following cloud_entity_types are supported: project, billing_account, folder and organization. EXAMPLES - Lists recommendations for a Cloud project. $ gcloud recommender recommendations list --project=project-name \ + Lists recommendations for a Cloud project. $ gcloud recommender recommendations list --project=project-id \ --location=global \ --recommender=google.compute.instance.MachineTypeRecommender REQUIRED FLAGS --location=LOCATION - Location + Location to list recommendations for. --recommender=RECOMMENDER Recommender to list recommendations for. Supported recommenders can be diff --git a/gcloud/recommender/recommendations/mark-claimed b/gcloud/recommender/recommendations/mark-claimed index 7ddab9b0a..3d04262e0 100644 --- a/gcloud/recommender/recommendations/mark-claimed +++ b/gcloud/recommender/recommendations/mark-claimed @@ -19,8 +19,8 @@ DESCRIPTION EXAMPLES To mark a recommendation as CLAIMED: - $ gcloud recommender recommendations mark-claimed RECOMMENDATION \ - --project=project-name --location=global \ + $ gcloud recommender recommendations mark-claimed abcd-1234 \ + --project=project-id --location=global \ --recommender=google.compute.instance.MachineTypeRecommender \ --etag=abc123 --state-metadata=key1=value1,key2=value2 diff --git a/gcloud/recommender/recommendations/mark-dismissed b/gcloud/recommender/recommendations/mark-dismissed index 97a429206..731e7298c 100644 --- a/gcloud/recommender/recommendations/mark-dismissed +++ b/gcloud/recommender/recommendations/mark-dismissed @@ -19,7 +19,7 @@ EXAMPLES To mark a recommendation as DISMISSED: $ gcloud recommender recommendations mark-dismissed abcd-1234 \ - --project=project-name --location=global \ + --project=project-id --location=global \ --recommender=google.compute.instance.MachineTypeRecommender \ --etag=abc123 diff --git a/gcloud/recommender/recommendations/mark-failed b/gcloud/recommender/recommendations/mark-failed index bc58adf2f..b1a98afd9 100644 --- a/gcloud/recommender/recommendations/mark-failed +++ b/gcloud/recommender/recommendations/mark-failed @@ -17,7 +17,7 @@ EXAMPLES To mark a recommendation as FAILED: $ gcloud recommender recommendations mark-failed abcd-1234 \ - --project=project-name --location=global \ + --project=project-id --location=global \ --recommender=google.compute.instance.MachineTypeRecommender \ --etag=abc123 --state-metadata=key1=value1,key2=value2 diff --git a/gcloud/recommender/recommendations/mark-succeeded b/gcloud/recommender/recommendations/mark-succeeded index cbce15c66..cf71eaf3c 100644 --- a/gcloud/recommender/recommendations/mark-succeeded +++ b/gcloud/recommender/recommendations/mark-succeeded @@ -17,7 +17,7 @@ EXAMPLES To mark a recommendation as SUCCEEDED: $ gcloud recommender recommendations mark-succeeded abcd-1234 \ - --project=project-name --location=global \ + --project=project-id --location=global \ --recommender=google.compute.instance.MachineTypeRecommender \ --etag=abc123 --state-metadata=key1=value1,key2=value2 diff --git a/gcloud/services/api-keys/create b/gcloud/services/api-keys/create new file mode 100644 index 000000000..f1271f87b --- /dev/null +++ b/gcloud/services/api-keys/create @@ -0,0 +1,124 @@ +NAME + gcloud services api-keys create - create an API key + +SYNOPSIS + gcloud services api-keys create [--annotations=[KEY=VALUE,...]] [--async] + [--display-name=DISPLAY_NAME] [--key-id=KEY_ID] + [--api-target=service=SERVICE,[...] + --allowed-application=[sha1_fingerprint=SHA1_FINGERPRINT, + package_name=PACKAGE_NAME,...] + | --allowed-bundle-ids=[ALLOWED_BUNDLE_IDS,...] + | --allowed-ips=[ALLOWED_IPS,...] + | --allowed-referrers=[ALLOWED_REFERRERS,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create an API key. + +EXAMPLES + To create a key with display name and allowed ips specified: + + $ gcloud services api-keys create --display-name="test name" \ + --allowed-ips=2620:15c:2c4:203:2776:1f90:6b3b:217,104.133.8.78 + + To create a key with annotations: + + $ gcloud services api-keys create --annotations=foo=bar,abc=def + + To create a key with user-specified key id: + + $ gcloud services api-keys create --key-id="my-key-id" + + To create a key with allowed referrers restriction: + + $ gcloud services api-keys create \ + --allowed-referrers="https://www.example.com/*,http://sub.exampl\ + e.com/*" + + To create a key with allowed ios app bundle ids: + + $ gcloud services api-keys create --allowed-bundle-ids=my.app + + To create a key with allowed android application: + + $ gcloud services api-keys create \ + --allowed-application=sha1_fingerprint=foo1,\ + package_name=bar.foo \ + --allowed-application=sha1_fingerprint=foo2,package_name=foo.bar + + To create a key with allowed api targets (service name only): + + $ gcloud services api-keys create \ + --api-target=service=bar.service.com \ + --api-target=service=foo.service.com + + To create a keys with allowed api targets (service and methods are + specified): + + $ gcloud services api-keys create --flags-file=my-flags.yaml + + The content of 'my-flags.yaml' is as following: + + - --api-target: + service: + - "foo.service.com" + - --api-target: + service: + - "bar.service.com" + methods: + - "foomethod" + - "barmethod" + +FLAGS + --annotations=[KEY=VALUE,...] + Annotations are key resource. Specify annotations as a key-value + dictionary for small amounts of arbitrary client data. + + --async + Return immediately, without waiting for the operation in progress to + complete. + + --display-name=DISPLAY_NAME + Display name of the key to create. + + --key-id=KEY_ID + User-specified ID of the key to create. + + --api-target=service=SERVICE,[...] + Repeatable. Specify service and optionally one or multiple specific + methods. Both fields are case insensitive. If you need to specify + methods, it should be specified with the --flags-file. See $ gcloud + topic flags-file for details. See the examples section for how to use + --api-target in --flags-file. + + At most one of these can be specified: + + --allowed-application=[sha1_fingerprint=SHA1_FINGERPRINT,package_name=PACKAGE_NAME,...] + Repeatable. Specify multiple allowed applications. The accepted keys + are sha1_fingerprint and package_name. + + --allowed-bundle-ids=[ALLOWED_BUNDLE_IDS,...] + iOS app's bundle ids that are allowed to use the key. + + --allowed-ips=[ALLOWED_IPS,...] + A list of the caller IP addresses that are allowed to make API calls + with this key. + + --allowed-referrers=[ALLOWED_REFERRERS,...] + A list of regular expressions for the referrer URLs that are allowed + to make API calls with this key. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha services api-keys create + + $ gcloud beta services api-keys create + diff --git a/gcloud/services/api-keys/delete b/gcloud/services/api-keys/delete new file mode 100644 index 000000000..3be8fc850 --- /dev/null +++ b/gcloud/services/api-keys/delete @@ -0,0 +1,70 @@ +NAME + gcloud services api-keys delete - delete an API key + +SYNOPSIS + gcloud services api-keys delete (KEY : --location=LOCATION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete an API key. + +EXAMPLES + Delete an API Key : + + $ gcloud services api-keys delete \ + projects/myproject/locations/global/keys/1234 + + $ gcloud services api-keys delete 1234 + +POSITIONAL ARGUMENTS + Key resource - The name of the key to delete. The arguments in this group + can be used to specify the attributes of this resource. (NOTE) Some + attributes are not given arguments in this group but can be set in other + ways. + + To set the project attribute: + ◆ provide the argument key on the command line with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + KEY + ID of the key or fully qualified identifier for the key. + + To set the key attribute: + ▸ provide the argument key on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location of the key. + + To set the location attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ location will default to global. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha services api-keys delete + + $ gcloud beta services api-keys delete + diff --git a/gcloud/services/api-keys/get-key-string b/gcloud/services/api-keys/get-key-string new file mode 100644 index 000000000..1533ee136 --- /dev/null +++ b/gcloud/services/api-keys/get-key-string @@ -0,0 +1,68 @@ +NAME + gcloud services api-keys get-key-string - get the key string of an API key + +SYNOPSIS + gcloud services api-keys get-key-string (KEY : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Get the key string of an API key + +EXAMPLES + To get the key string of API key 1234, run: + + $ gcloud services api-keys get-key-string 1234 + + To get the key string of API key 1234 in project myproject using the fully + qualified API key name, run: + + $ gcloud services api-keys get-key-string \ + projects/myproject/locations/global/keys/1234 + +POSITIONAL ARGUMENTS + Key resource - The name of the key to retrieve key string. The arguments + in this group can be used to specify the attributes of this resource. + (NOTE) Some attributes are not given arguments in this group but can be + set in other ways. + + To set the project attribute: + ◆ provide the argument key on the command line with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + KEY + ID of the key or fully qualified identifier for the key. + + To set the key attribute: + ▸ provide the argument key on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location of the key. + + To set the location attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ location will default to global. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha services api-keys get-key-string + + $ gcloud beta services api-keys get-key-string + diff --git a/gcloud/services/api-keys/help b/gcloud/services/api-keys/help index 1055394f6..dcb1d3d77 100644 --- a/gcloud/services/api-keys/help +++ b/gcloud/services/api-keys/help @@ -15,15 +15,27 @@ GCLOUD WIDE FLAGS COMMANDS COMMAND is one of the following: + create + Create an API key. + + delete + Delete an API key. + describe Describe an API key's metadata. + get-key-string + Get the key string of an API key. + list Lists API keys. lookup Look up resource name of a key string. + update + Update an API key's metadata. + NOTES These variants are also available: diff --git a/gcloud/services/api-keys/update b/gcloud/services/api-keys/update new file mode 100644 index 000000000..c5b0eb53f --- /dev/null +++ b/gcloud/services/api-keys/update @@ -0,0 +1,168 @@ +NAME + gcloud services api-keys update - update an API key's metadata + +SYNOPSIS + gcloud services api-keys update (KEY : --location=LOCATION) [--async] + [--display-name=DISPLAY_NAME] + [--annotations=[KEY=VALUE,...] | --clear-annotations] + [--clear-restrictions | --api-target=service=SERVICE,[...] + --allowed-application=[sha1_fingerprint=SHA1_FINGERPRINT, + package_name=PACKAGE_NAME,...] + | --allowed-bundle-ids=[ALLOWED_BUNDLE_IDS,...] + | --allowed-ips=[ALLOWED_IPS,...] + | --allowed-referrers=[ALLOWED_REFERRERS,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update an API key's metadata. + +EXAMPLES + To remove all restrictions of the key: + + $ gcloud services api-keys update \ + projects/myproject/keys/my-key-id --clear-restrictions + + To update display name and set allowed ips as server key restrictions: + + $ gcloud services api-keys update \ + projects/myproject/keys/my-key-id --display-name="test name" \ + --allowed-ips=2620:15c:2c4:203:2776:1f90:6b3b:217,104.133.8.78 + + To update annotations: + + $ gcloud services api-keys update \ + projects/myproject/keys/my-key-id --annotations=foo=bar,abc=def + + To update key's allowed referrers restriction: + + $ gcloud services api-keys update \ + projects/myproject/keys/my-key-id \ + --allowed-referrers="https://www.example.com/*,http://sub.exampl\ + e.com/*" + + To update key's allowed ios app bundle ids: + + $ gcloud services api-keys update \ + projects/myproject/keys/my-key-id --allowed-bundle-ids=my.app + + To update key's allowed android application: + + $ gcloud services api-keys update \ + projects/myproject/keys/my-key-id \ + --allowed-application=sha1_fingerprint=foo1,package_name=bar1 \ + --allowed-application=sha1_fingerprint=foo2,package_name=bar2 + + To update keys' allowed api target with multiple services: + + $ gcloud services api-keys update \ + projects/myproject/keys/my-key-id \ + --api-target=service=bar.service.com \ + --api-target=service=foo.service.com + + To update keys' allowed api target with service and method: + + $ gcloud services api-keys update \ + projects/myproject/keys/my-key-id --flags-file=my-flags.yaml + + The content of 'my-flags.yaml' is as following: + + - --api-target: + service: "foo.service.com" + - --api-target: + service: "bar.service.com" + methods: + - "foomethod" + - "barmethod" + +POSITIONAL ARGUMENTS + Key resource - The name of the key to update. The arguments in this group + can be used to specify the attributes of this resource. (NOTE) Some + attributes are not given arguments in this group but can be set in other + ways. + + To set the project attribute: + ◆ provide the argument key 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. + + KEY + ID of the key or fully qualified identifier for the key. + + To set the key attribute: + ▸ provide the argument key on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location of the key. + + To set the location attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ location will default to global. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --display-name=DISPLAY_NAME + Display name of the key to update. + + At most one of these can be specified: + + --annotations=[KEY=VALUE,...] + Annotations are key resource. Specify annotations as a key-value + dictionary for small amounts of arbitrary client data. + + --clear-annotations + If set, clear all annotations on the key. + + At most one of these can be specified: + + --clear-restrictions + If set, clear all restrictions on the key. + + --api-target=service=SERVICE,[...] + Repeatable. Specify service and optionally one or multiple specific + methods. Both fields are case insensitive. If you need to specify + methods, it should be specified with the --flags-file. See $ gcloud + topic flags-file for details. See the examples section for how to use + --api-target in --flags-file. + + At most one of these can be specified: + + --allowed-application=[sha1_fingerprint=SHA1_FINGERPRINT,package_name=PACKAGE_NAME,...] + Repeatable. Specify multiple allowed applications. The accepted + keys are sha1_fingerprint and package_name. + + --allowed-bundle-ids=[ALLOWED_BUNDLE_IDS,...] + iOS app's bundle ids that are allowed to use the key. + + --allowed-ips=[ALLOWED_IPS,...] + A list of the caller IP addresses that are allowed to make API + calls with this key. + + --allowed-referrers=[ALLOWED_REFERRERS,...] + A list of regular expressions for the referrer URLs that are + allowed to make API calls with this key. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha services api-keys update + + $ gcloud beta services api-keys update + diff --git a/gcloud/source/repos/clone b/gcloud/source/repos/clone index 434d291eb..ca15e7d19 100644 --- a/gcloud/source/repos/clone +++ b/gcloud/source/repos/clone @@ -29,7 +29,7 @@ EXAMPLES $ cd DIRECTORY_NAME ... create/edit files and create one or more \ commits ... - $ git push origin master + $ git push origin main POSITIONAL ARGUMENTS REPOSITORY_NAME diff --git a/gcloud/workstations/configs/create b/gcloud/workstations/configs/create index 75b93efbd..eaf3798af 100644 --- a/gcloud/workstations/configs/create +++ b/gcloud/workstations/configs/create @@ -10,8 +10,8 @@ SYNOPSIS [--container-env=[CONTAINER_ENV,...]] [--container-run-as-user=CONTAINER_RUN_AS_USER] [--container-working-dir=CONTAINER_WORKING_DIR] - [--disable-public-ip-addresses] [--enable-confidential-compute] - [--enable-nested-virtualization] + [--disable-public-ip-addresses] [--enable-audit-agent] + [--enable-confidential-compute] [--enable-nested-virtualization] [--idle-timeout=IDLE_TIMEOUT; default=7200] [--labels=[LABELS,...]] [--machine-type=MACHINE_TYPE; default="e2-standard-4"] [--network-tags=[NETWORK_TAGS,...]] @@ -135,6 +135,11 @@ FLAGS Default value is false. If set, instances will have no public IP address. + --enable-audit-agent + Whether to enable Linux auditd logging on the workstation. When + enabled, a service account must also be specified that has + logging.buckets.write permission on the project. + --enable-confidential-compute Default value is false. If set, instances will have confidential compute enabled. diff --git a/gcloud/workstations/configs/update b/gcloud/workstations/configs/update index 69df64cdf..f2da48242 100644 --- a/gcloud/workstations/configs/update +++ b/gcloud/workstations/configs/update @@ -10,11 +10,12 @@ SYNOPSIS [--container-env=[CONTAINER_ENV,...]] [--container-run-as-user=CONTAINER_RUN_AS_USER] [--container-working-dir=CONTAINER_WORKING_DIR] - [--disable-public-ip-addresses] [--enable-confidential-compute] - [--enable-nested-virtualization] [--idle-timeout=IDLE_TIMEOUT] - [--labels=[LABELS,...]] [--machine-type=MACHINE_TYPE] - [--network-tags=[NETWORK_TAGS,...]] [--pool-size=POOL_SIZE] - [--running-timeout=RUNNING_TIMEOUT] [--service-account=SERVICE_ACCOUNT] + [--disable-public-ip-addresses] [--enable-audit-agent] + [--enable-confidential-compute] [--enable-nested-virtualization] + [--idle-timeout=IDLE_TIMEOUT] [--labels=[LABELS,...]] + [--machine-type=MACHINE_TYPE] [--network-tags=[NETWORK_TAGS,...]] + [--pool-size=POOL_SIZE] [--running-timeout=RUNNING_TIMEOUT] + [--service-account=SERVICE_ACCOUNT] [--service-account-scopes=[SERVICE_ACCOUNT_SCOPES,...]] [--shielded-integrity-monitoring] [--shielded-secure-boot] [--shielded-vtpm] @@ -122,6 +123,11 @@ FLAGS Default value is false. If set, instances will have no public IP address. + --enable-audit-agent + Whether to enable Linux auditd logging on the workstation. When + enabled, a service account must also be specified that has + logging.buckets.write permission on the project. + --enable-confidential-compute Default value is false. If set, instances will have confidential compute enabled.