gcloud alpha bigtable app-profiles update Stay organized with collections Save and categorize content based on your preferences.
- NAME
- gcloud alpha bigtable app-profiles update - update a Bigtable app profile
- SYNOPSIS
gcloud alpha bigtable app-profiles update(APP_PROFILE:--instance=INSTANCE)[--async][--description=DESCRIPTION][--force][--data-boost--data-boost-compute-billing-owner=DATA_BOOST_COMPUTE_BILLING_OWNER| [--priority=PRIORITY:--standard]][[--route-any:--restrict-to=[RESTRICT_TO,…]--row-affinity] | [--route-to=ROUTE_TO:--transactional-writes]][GCLOUD_WIDE_FLAG …]
- DESCRIPTION
(ALPHA)Update a Bigtable app profile.- EXAMPLES
- To update an app profile to use a multi-cluster routing policy, run:
gcloudalphabigtableapp-profilesupdatemy-app-profile-id--instance=my-instance-id--route-anyTo update an app profile to use a single-cluster routing policy that routes allrequests to
my-cluster-idand allows transactional writes, run:gcloudalphabigtableapp-profilesupdatemy-app-profile-id--instance=my-instance-id--route-to=my-cluster-id--transactional-writesTo update the description for an app profile, run:
gcloudalphabigtableapp-profilesupdatemy-app-profile-id--instance=my-instance-id--description="New description"To update the request priority for an app profile to PRIORITY_LOW, run:
gcloudalphabigtableapp-profilesupdatemy-app-profile-id--instance=my-instance-id--priority=PRIORITY_LOWTo update an app profile to enable Data Boost which bills usage to the hostproject, run:
gcloudalphabigtableapp-profilesupdatemy-app-profile-id--instance=my-instance-id--data-boost--data-boost-compute-billing-owner=HOST_PAYSTo update an app profile to enable row-affinity routing, run:
gcloudalphabigtableapp-profilesupdatemy-app-profile-id--instance=my-instance-id--route-any--row-affinity - POSITIONAL ARGUMENTS
- App profile resource - The app profile to update. The arguments in this groupcan be used to specify the attributes of this resource. (NOTE) Some attributesare not given arguments in this group but can be set in other ways.
To set the
projectattribute:- provide the argument
app_profileon the command line with a fullyspecified name; - provide the argument
--projecton the command line; - set the property
core/project.
This must be specified.
APP_PROFILE- ID of the app profile or fully qualified identifier for the app profile.
To set the
nameattribute:- provide the argument
app_profileon the command line.
This positional argument must be specified if any of the other arguments in thisgroup are specified.
- provide the argument
--instance=INSTANCE- Bigtable instance for the app profile.
To set the
instanceattribute:- provide the argument
app_profileon the command line with a fullyspecified name; - provide the argument
--instanceon the command line.
- provide the argument
- provide the argument
- App profile resource - The app profile to update. The arguments in this groupcan be used to specify the attributes of this resource. (NOTE) Some attributesare not given arguments in this group but can be set in other ways.
- FLAGS
--async- Return immediately, without waiting for the operation in progress to complete.
--description=DESCRIPTION- Friendly name of the app profile.
--force- Ignore warnings and force update.
- At most one of these can be specified:
- Data Boost Read-only Isolation
--data-boost- Use Data Boost serverless compute option, rather than standard provisioned nodecompute. If specified, --data-boost-compute-billing-owner is required.Specifying Data Boost compute on an app profile that uses standard provisionednode compute may cause unexpected behavior for running applications.
This flag argument must be specified if any of the other arguments in this groupare specified.
--data-boost-compute-billing-owner=DATA_BOOST_COMPUTE_BILLING_OWNER- Specify the Data Boost compute billing owner, required if --data-boost ispassed.
DATA_BOOST_COMPUTE_BILLING_OWNERmust be (onlyone value is supported):HOST_PAYS- Compute billing should be accounted towards the host Cloud project (containingthe targeted Bigtable instance / table).
- Standard Isolation
--priority=PRIORITY- Specify the request priority under standard provisioned node computecapabilities. Passing this option implies standard provisioned node compute,e.g. the
--standardoption. If not specified, the app profile usesstandard provisioned node compute with PRIORITY_HIGH by default. Specifyingrequest priority on an app profile that has Data Boost serverless computeenabled changes the compute option to standard and uses the specified priority,which might cause unexpected behavior for running applications.PRIORITYmust be one of:PRIORITY_HIGH- Requests are treated with high priority.
PRIORITY_LOW- Requests are treated with low priority.
PRIORITY_MEDIUM- Requests are treated with medium priority.
--standard- Use standard provisioned node compute option, rather than Data Boost computeoption. If specified,
--priorityis required.
- Data Boost Read-only Isolation
- At most one of these can be specified:
- Multi Cluster Routing Policy
--route-any- Use Multi Cluster Routing policy.
This flag argument must be specified if any of the other arguments in this groupare specified.
--restrict-to=[RESTRICT_TO,…]- Cluster IDs to route to using the Multi Cluster Routing Policy. If unset, allclusters in the instance are eligible.
--row-affinity- Use row-affinity routing for this app profile.
- Single Cluster Routing Policy
--route-to=ROUTE_TO- Cluster ID to route to using Single Cluster Routing policy.
This flag argument must be specified if any of the other arguments in this groupare specified.
--transactional-writes- Allow transactional writes with a Single Cluster Routing policy.
- Multi Cluster Routing 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 helpfor details. - NOTES
- This command is currently in alpha and might change without notice. If thiscommand fails with API permission errors despite specifying the correct project,you might be trying to access an API with an invitation-only early accessallowlist. These variants are also available:
gcloudbigtableapp-profilesupdategcloudbetabigtableapp-profilesupdate
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-05-07 UTC.