## NAME

gdcloud compute instances add-metadata - Add metadata for a virtual machine instance.

## SYNOPSIS

```text
gdcloud compute instances add-metadata INSTANCE_NAME [flags]
```

### EXAMPLES

```text
To add metadata for key "example-key" for a virtual machine instance named "example-instance" in project "example-project in non multi zone environment", run:

    gdcloud compute instances add-metadata example-instance --project example-project --metadata=example-key="example value"

To add metadata for key "example-key" for a virtual machine instance named "example-instance" in project "example-project in multi zone environment", run:

    gdcloud compute instances add-metadata example-instance --project example-project --metadata=example-key="example value --zone=zone1"

To add metadata under key "important-data" to an instance named "example-instance" using file "example-file in non multi zone environment", run:

    gdcloud compute instances add-metadata example-instance --project example-project --metadata-from-file=important-data=example-file.txt

To add metadata under key "important-data" to an instance named "example-instance" using file "example-file in multi zone environment", run:

    gdcloud compute instances add-metadata example-instance --project example-project --metadata-from-file=important-data=example-file.txt --zone=zone1
```

### OPTIONAL FLAGS

```text
      --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 [])
      --zone string                         Zone to use for this invocation. To preset the zone flag for all commands that require it, run: "gdcloud config set core/zone ZONE". The zone flag is available only in multi-zone environments.
```

### GDCLOUD WIDE FLAGS

These flags are available to all commands: `--configuration`, `--format`, `--help`, `--project`, `--quiet`.

For more information, see the [gdcloud CLI reference overview](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/resources/gdcloud-reference/gdcloud.md.txt) page.