- NAME
-
- gcloud alpha compute disks update - update a Compute Engine persistent disk
- SYNOPSIS
-
-
gcloud alpha compute disks update
DISK_NAME
[--access-mode
=ACCESS_MODE
] [--provisioned-iops
=PROVISIONED_IOPS
] [--provisioned-throughput
=PROVISIONED_THROUGHPUT
] [--size
=SIZE
] [--update-labels
=[KEY
=VALUE
,…]] [--clear-architecture
|--update-architecture
=UPDATE_ARCHITECTURE
] [--clear-labels
|--remove-labels
=[KEY
,…]] [--clear-user-licenses
|--update-user-licenses
=[LICENSE
,…]] [--region
=REGION
|--zone
=ZONE
] [GCLOUD_WIDE_FLAG …
]
-
- DESCRIPTION
-
(ALPHA)
gcloud alpha compute disks update
updates a Compute Engine persistent disk. - EXAMPLES
-
To update labels 'k0' and 'k1' and remove label 'k3' of a disk, run:
gcloud alpha compute disks update example-disk --zone=us-central1-a --update-labels=k0=value1,k1=value2 --remove-labels=k3
`_k0_` and `_k1_` are added as new labels if not already present.
Labels can be used to identify the disk. To list disks with the 'k1:value2' label, run:
gcloud alpha compute disks list --filter='labels.k1:value2'
To list only the labels when describing a resource, use --format to filter the result:
gcloud alpha compute disks describe example-disk --format="default(labels)"
- POSITIONAL ARGUMENTS
-
DISK_NAME
- Name of the disk to update.
- FLAGS
-
--access-mode
=ACCESS_MODE
-
Specifie how VMs attached to the disk can access the data on the disk. To grant
read-only access to multiple VMs attached to the disk, set access-mode to
READ_ONLY_MANY. To grant read-write access to only one VM attached to the disk,
use READ_WRITE_SINGLE. READ_WRITE_SINGLE is used if omitted.
ACCESS_MODE
must be one of:READ_ONLY_MANY
,READ_WRITE_MANY
,READ_WRITE_SINGLE
. --provisioned-iops
=PROVISIONED_IOPS
- Provisioned IOPS of disk to update. Only for use with disks of type hyperdisk-extreme.
--provisioned-throughput
=PROVISIONED_THROUGHPUT
- Provisioned throughput of disk to update. The throughput unit is MB per sec.
--size
=SIZE
-
Size of the disks. The value must be a whole number followed by a size unit of
for gigabyte, orGB
for terabyte. If no size unit is specified, GB is assumed. For details about disk size limits, refer to: https://cloud.google.com/compute/docs/disksTB
--update-labels
=[KEY
=VALUE
,…]-
List of label KEY=VALUE pairs to update. If a label exists, its value is
modified. Otherwise, a new label is created.
Keys must start with a lowercase character and contain only hyphens (
-
), underscores (_
), lowercase characters, and numbers. Values must contain only hyphens (-
), underscores (_
), lowercase characters, and numbers. -
At most one of these can be specified:
--clear-architecture
- Removes the architecture or processor type annotation from the disk.
--update-architecture
=UPDATE_ARCHITECTURE
-
Updates the architecture or processor type that this disk can support. For
available processor types on Compute Engine, see https://cloud.google.com/compute/docs/cpu-platforms.
UPDATE_ARCHITECTURE
must be one of:ARM64
,X86_64
.
-
At most one of these can be specified:
--clear-labels
-
Remove all labels. If
--update-labels
is also specified then--clear-labels
is applied first.For example, to remove all labels:
gcloud alpha compute disks update --clear-labels
To remove all existing labels and create two new labels,
andfoo
:baz
gcloud alpha compute disks update --clear-labels --update-labels foo=bar,baz=qux
--remove-labels
=[KEY
,…]-
List of label keys to remove. If a label does not exist it is silently ignored.
If
--update-labels
is also specified then--update-labels
is applied first.
-
At most one of these can be specified:
--clear-user-licenses
- Remove all existing user licenses on a disk.
--update-user-licenses
=[LICENSE
,…]- List of user licenses to be updated on a disk. These user licenses will replace all existing user licenses. If this flag is not provided, all existing user licenses will remain unchanged.
-
At most one of these can be specified:
--region
=REGION
-
Region of the disk to update. If not specified, you might be prompted to select
a region (interactive mode only).
To avoid prompting when this flag is omitted, you can set the
property:compute/region
gcloud config set compute/region REGION
A list of regions can be fetched by running:
gcloud compute regions list
To unset the property, run:
gcloud config unset compute/region
Alternatively, the region can be stored in the environment variable
.CLOUDSDK_COMPUTE_REGION
--zone
=ZONE
-
Zone of the disk to update. If not specified and the
property isn't set, you might be prompted to select a zone (interactive mode only).compute/zone
To avoid prompting when this flag is omitted, you can set the
property:compute/zone
gcloud config set compute/zone ZONE
A list of zones can be fetched by running:
gcloud compute zones list
To unset the property, run:
gcloud config unset compute/zone
Alternatively, the zone can be stored in the environment variable
.CLOUDSDK_COMPUTE_ZONE
- GCLOUD WIDE FLAGS
-
These flags are available to all commands:
--access-token-file
,--account
,--billing-project
,--configuration
,--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 compute disks update
gcloud beta compute disks update
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-06-11 UTC.
[{
"type": "thumb-down",
"id": "hardToUnderstand",
"label":"Hard to understand"
},{
"type": "thumb-down",
"id": "incorrectInformationOrSampleCode",
"label":"Incorrect information or sample code"
},{
"type": "thumb-down",
"id": "missingTheInformationSamplesINeed",
"label":"Missing the information/samples I need"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Other"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Easy to understand"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Solved my problem"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Other"
}]
{
"last_modified": "Last updated 2024-06-11 UTC.",
"state": ""
}