# read

### **Usage**

```
vhsm nitride annotation read <key>
```

* "key": The exact attestation value to query. It can be provided as plain text or in base64 form. If the value contains reserved URL characters (`/`, `+`, `=`), you must URL-encode it before passing it in the `curl` request. \
  To URL-encode keys on the command line:
  * Python:

    ```bash
    python3 -c "import urllib.parse; print(urllib.parse.quote('8aFCxTWG5+IiPsdOX00aSUKVax/ZrHj6/N+FEXqjRdo='))"
    ```
  * &#x20;`jq`:

    ```bash
    jq -rn --arg v '8aFCxTWG5+IiPsdOX00aSUKVax/ZrHj6/N+FEXqjRdo=' '$v|@uri'
    ```

#### Flags

* [Global HTTP Options](/nitride/cli.md#global-options)
* [Output Options](/nitride/cli.md#output-options)
* [Command Options](/nitride/cli.md#command-options)

**Example**

Read an existing annotation:

```
vhsm nitride annotation read 8aFCxTWG5+IiPsdOX00aSUKVax/ZrHj6/N+FEXqjRdo=
```

#### Output

```
rkodhandapani@blr-mpqob ~ % vhsm nitride annotation read 8aFCxTWG5+IiPsdOX00aSUKVax/ZrHj6/N+FEXqjRdo=
Key        Value
---        -----
created    1756126542
key        8aFCxTWG5+IiPsdOX00aSUKVax/ZrHj6/N+FEXqjRdo=
value      Kernel Command Line / Enclaive Buckypaper v1.0.0 / 2025-06-20
```

**Detailed Explanation**

* key: Must match exactly what was used when creating the annotation. Base64 values are common; ensure correct encoding and consider URL‑encoding when passing keys with reserved characters using cURL.
* value: Returned from the stored annotation to make raw attestation values understandable.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.enclaive.cloud/nitride/cli/annotation/read.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.