To add metadata for key "example-key" for a virtual machine instance named "example-instance" in project "example-project", run:
gdcloud compute instances add-metadata example-instance --project example-project --metadata=example-key="example value"
To add metadata under key "important-data" to an instance named "example-instance" using file "example-file"
gdcloud compute instances add-metadata example-instance --project example-project \
--metadata-from-file=important-data=example-file.txt
選用旗標
--metadata stringToString List of comma-separated key-value pair metadata to add to the virtual machine instance.
For example, --metadata=key1="val1",key2="val2". At least one of the flags --metadata or --metadata-from-file is required. (default [])
--metadata-from-file stringToString List of comma-separated KEY=LOCAL_FILE_PATH metadata to add to the virtual machine instance. The value of the key is read from the file provided.
For example, --metadata-from-file=key1=filepath1,key2=filepath2. At least one of the flags --metadata or --metadata-from-file is required. (default [])
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["難以理解","hardToUnderstand","thumb-down"],["資訊或程式碼範例有誤","incorrectInformationOrSampleCode","thumb-down"],["缺少我需要的資訊/範例","missingTheInformationSamplesINeed","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2025-09-04 (世界標準時間)。"],[],[],null,["# gdcloud compute instances add-metadata\n\nNAME\n----\n\ngdcloud compute instances add-metadata - Add metadata for a virtual machine instance.\n\nSYNOPSIS\n--------\n\n gdcloud compute instances add-metadata INSTANCE_NAME [flags]\n\n### EXAMPLES\n\n To add metadata for key \"example-key\" for a virtual machine instance named \"example-instance\" in project \"example-project\", run:\n\n gdcloud compute instances add-metadata example-instance --project example-project --metadata=example-key=\"example value\"\n\n To add metadata under key \"important-data\" to an instance named \"example-instance\" using file \"example-file\"\n gdcloud compute instances add-metadata example-instance --project example-project \\\n --metadata-from-file=important-data=example-file.txt\n\n### OPTIONAL FLAGS\n\n --metadata stringToString List of comma-separated key-value pair metadata to add to the virtual machine instance.\n For example, --metadata=key1=\"val1\",key2=\"val2\". At least one of the flags --metadata or --metadata-from-file is required. (default [])\n --metadata-from-file stringToString List of comma-separated KEY=LOCAL_FILE_PATH metadata to add to the virtual machine instance. The value of the key is read from the file provided.\n For example, --metadata-from-file=key1=filepath1,key2=filepath2. At least one of the flags --metadata or --metadata-from-file is required. (default [])\n\n### GDCLOUD WIDE FLAGS\n\nThese flags are available to all commands: `--configuration`, `--format`, `--help`, `--project`, `--quiet`.\n\nFor more information, see the [gdcloud CLI reference overview](/distributed-cloud/hosted/docs/latest/appliance/resources/gdcloud-reference/gdcloud) page."]]